@codmir/agent-core

@codmir/agent-core

Core orchestrator for the Codmir Agent Intelligence System - a 5-layer AI coding agent inspired by Claude Code, Cursor IDE, and Windsurf.

Features

• 🗺️ Context Map - Navigate large codebases without loading everything into memory
• 🔧 Skill System - Extensible tool system with 20+ built-in skills
• 📋 Workflows - Reusable multi-step procedures for common tasks
• 🧠 Knowledge Base - Durable project knowledge that grows over time
• 🤖 Model Routing - Automatic AI model selection (Claude/Gemini/Local)

Installation

npm install @codmir/agent-core

Quick Start

import { AgentCore } from '@codmir/agent-core';

const agent = new AgentCore({
  rootPath: process.cwd(),
  anthropicApiKey: process.env.ANTHROPIC_API_KEY,
  googleApiKey: process.env.GOOGLE_API_KEY,
});

await agent.initialize();

// Execute a workflow
const result = await agent.execute({
  goal: 'Analyze the authentication system',
  type: 'analyze',
  workflowName: 'trace-feature',
});

Architecture

AgentCore (Orchestrator)
├── RepoIndex     (Layer 1: File scanning)
├── ContextMap    (Layer 2: Code navigation)
├── WorkflowEngine (Layer 3: Task procedures)
├── KnowledgeBase (Layer 4: Durable knowledge)
├── SkillRuntime  (Layer 5: Executable tools)
└── ModelRouter   (AI provider selection)

Built-in Workflows

• analyze-codebase - Full repository analysis
• trace-feature - Follow feature across UI/API/DB
• safe-refactor-plan - Generate refactoring plan
• next15-app-router-audit - Audit Next.js App Router

Core Skills

Read: list_files, search_repo, read_file, read_symbols, trace_imports
Analysis: summarize_module
Write: write_report (requires approval)

Documentation

• Usage Guide
• Architecture

License

MIT