code-context-agent¶

AI-powered CLI tool for automated codebase analysis and context generation.

code-context-agent uses Claude Opus 4.6 (via Amazon Bedrock) with 45+ tools to analyze unfamiliar codebases and produce structured context documentation for AI coding assistants. It combines semantic analysis (LSP), structural pattern matching (ast-grep), graph algorithms (NetworkX), git history analysis, and intelligent code bundling (repomix) to generate narrated markdown that helps developers and AI assistants understand a codebase's architecture and business logic.

Key Capabilities¶

Architecture¶

flowchart TD
    A[CLI: cyclopts] --> B[run_analysis]
    B --> C[create_agent]
    C --> D[Strands Agent<br/>Opus 4.6 + adaptive thinking]
    D --> E[Jinja2 System Prompt]
    D --> F[HookProviders<br/>quality + efficiency + fail-fast]
    D --> G[AnalysisResult<br/>structured output]
    D --> H[Tool Execution]
    H --> I[Discovery<br/>ripgrep, repomix]
    H --> J[LSP<br/>ty, ts-server, rust-analyzer]
    H --> K[AST<br/>ast-grep patterns]
    H --> L[Graph<br/>NetworkX analysis]
    H --> M[Git<br/>coupling, churn, blame]
    H --> N[Shell<br/>bounded execution]
    H --> O[Output Files<br/>.code-context/ directory]

Quick Start¶

# Install
uv tool install code-context-agent

# Analyze a repository
code-context-agent analyze /path/to/repo

# Focus on a specific area
code-context-agent analyze . --focus "authentication system"

# Verify tool dependencies
code-context-agent check

# Exhaustive analysis (no size limits, fail-fast)
code-context-agent analyze . --full

# Full analysis focused on specific area
code-context-agent analyze . --full --focus "authentication"

See the Installation and Quick Start guides for details.

Output¶

All outputs are written to .code-context/ (or custom --output-dir):

Tech Stack¶