CodeEagle
CodeEagle is a CLI tool that indexes codebases into a knowledge graph and exposes AI agents for planning, design review, and code review — all grounded in deep codebase understanding.
It supports monorepos, multi-repo setups, and multi-language codebases (Go, Python, TypeScript, JavaScript, Java, Rust, C#, Ruby, HTML, Markdown, Makefile, Shell, Terraform, YAML). No external database required — the embedded graph store runs locally with zero setup.
Features
- Knowledge graph of source code entities (functions, classes, interfaces, packages, services) and their relationships (calls, imports, implements, tests, etc.)
- 15 language parsers: Go (stdlib AST), Python, TypeScript, JavaScript, Java, Rust, C# (with ASP.NET), Ruby (with Rails), HTML, Markdown, Makefile, Shell, Terraform, YAML, plus a manifest parser (go.mod, package.json, pyproject.toml, requirements.txt)
- Document format extraction: Text extraction from DOCX, PPTX, XLSX, ODT, ODS, ODP (pure Go, stdlib only) and PDF (
dslipak/pdf). Documents are indexed, topic-extracted via LLM, and semantically searchable
- Non-code file indexing: Changelogs, design docs, CSVs, images, config templates — all indexed as Document nodes with optional LLM-based topic extraction and image description
- Cross-service dependency analysis: API endpoint extraction, HTTP client call detection, import-to-manifest linking, cross-file interface implements resolution
- Test coverage mapping: automatic test file/function detection across 8 languages with
EdgeTests linking to source counterparts
- Code quality metrics: cyclomatic complexity, lines of code, TODO/FIXME counts
- Graph analysis queries: unused code detection and test coverage reporting
- AI agents for planning, design, code review, and freeform Q&A — read-only, advisory, never modify code
- Git-aware incremental sync with branch tracking and diff-based updates
- MCP server for integration with Claude Code and other MCP-compatible tools
- LLM auto-summarization of services and architectural patterns
Installation
Pre-built Binaries (Recommended)
Download the latest release for your platform from GitHub Releases:
- Linux:
codeeagle-linux-amd64.tar.gz, codeeagle-linux-arm64.tar.gz
- macOS:
codeeagle-darwin-amd64.tar.gz, codeeagle-darwin-arm64.tar.gz
Extract and move to your PATH:
tar -xzf codeeagle-<platform>.tar.gz
sudo mv codeeagle /usr/local/bin/
To update to the latest version:
codeeagle update
Build from Source
Requires Go 1.24+ and a C compiler (gcc or clang) — needed for tree-sitter parsing via CGO.
go install github.com/imyousuf/CodeEagle/cmd/codeeagle@latest
Or clone and build:
git clone https://github.com/imyousuf/CodeEagle.git
cd CodeEagle
make build
# Binary: bin/codeeagle
Quick Start
# 1. Initialize a project (creates .CodeEagle/ directory)
codeeagle init # quick setup with defaults
codeeagle init --interactive # guided setup wizard
# 2. Index the codebase
codeeagle sync
# 3. Check indexing status
codeeagle status
# 4. Ask an AI agent a question
codeeagle agent plan "What would be affected if I change the Store interface?"
codeeagle agent design "How is authentication handled across services?"
codeeagle agent review --diff HEAD~1
codeeagle agent ask "What are the largest packages by node count?"
CLI Reference
codeeagle init [--interactive|-i] Initialize project config
codeeagle config View current configuration
codeeagle config edit Edit configuration interactively
codeeagle sync [--full] Sync knowledge graph (incremental or full)
codeeagle sync --export Export graph to portable file
codeeagle sync --import Import a graph export
codeeagle watch Watch for file changes and sync continuously
codeeagle status Show indexing status and graph stats
codeeagle agent plan <query> Impact analysis, dependency mapping, scope estimation
codeeagle agent design <query> Architecture review and pattern recognition
codeeagle agent review <query> Code review against codebase conventions
codeeagle agent review --diff <ref> Review a git diff
codeeagle agent ask <query> Freeform Q&A about the codebase
