codeeagle

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