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 27+ analysis tools to analyze unfamiliar codebases and produce structured context documentation for AI coding assistants. It combines structural code intelligence (GitNexus), BM25 ranked search, git history analysis, static scanners (semgrep, ruff, ty, radon, vulture), 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[analyze command]
    A --> IDX[index command]
    A --> CHK[check command]
    IDX --> IDXP[Deterministic Indexer<br/>16 steps]
    IDXP --> HS[heuristic_summary.json<br/>bridge artifact]
    B --> COORD[Coordinator Agent<br/>reads heuristic_summary.json]
    COORD --> DT[dispatch_team<br/>parallel specialist teams]
    DT --> T1[Team 1]
    DT --> T2[Team 2]
    DT --> TN[Team N]
    T1 & T2 & TN --> RF[read_team_findings<br/>collect results]
    RF --> WB[write_bundle<br/>generate output]
    WB --> OUT[CONTEXT.md +<br/>bundles/BUNDLE.area.md]
    COORD -.-> F[HookProviders<br/>quality + efficiency + fail-fast]
    COORD -.-> GP[Pre-loaded Graph<br/>from index]

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

# Quick index without LLM (fast, cheap)
code-context-agent index .

# Interactive visualization
code-context-agent viz .

See the Installation and Quick Start guides for details.

Output¶

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

Tech Stack¶