codebase-agent ⚡

Understand any codebase in minutes. Download, run, ask questions.

Zero setup. No API keys needed. Powered by Ollama Cloud.

Install

macOS (Apple Silicon)

curl -L https://github.com/devthedeveloper/codebase-agent-go/releases/latest/download/codebase-agent-darwin-arm64 -o codebase-agent
chmod +x codebase-agent
sudo mv codebase-agent /usr/local/bin/

macOS (Intel)

curl -L https://github.com/devthedeveloper/codebase-agent-go/releases/latest/download/codebase-agent-darwin-amd64 -o codebase-agent
chmod +x codebase-agent
sudo mv codebase-agent /usr/local/bin/

Linux (x86_64)

curl -L https://github.com/devthedeveloper/codebase-agent-go/releases/latest/download/codebase-agent-linux-amd64 -o codebase-agent
chmod +x codebase-agent
sudo mv codebase-agent /usr/local/bin/

Linux (ARM64)

curl -L https://github.com/devthedeveloper/codebase-agent-go/releases/latest/download/codebase-agent-linux-arm64 -o codebase-agent
chmod +x codebase-agent
sudo mv codebase-agent /usr/local/bin/

Windows

Download codebase-agent-windows-amd64.exe from releases.

Usage

# Interactive Q&A about a codebase
codebase-agent ask ./my-project

# Ask a single question
codebase-agent ask ./my-project -q "How does authentication work?"

# View repo stats
codebase-agent scan ./my-project

What it does

1. Scans your repo (Python, JS/TS, Java, Go, Rust, C/C++, Ruby, PHP, C#, Kotlin, Swift)
2. Builds a context from file structure + source code
3. Streams answers from an AI model that understands your codebase

Supported Languages

Python, JavaScript, TypeScript, Java, Go, Rust, C, C++, Ruby, PHP, C#, Kotlin, Swift

Examples

$ codebase-agent ask ./my-api -q "Where is rate limiting implemented?"

$ codebase-agent ask ./frontend -q "How does the auth flow work?"

$ codebase-agent ask ./microservice -q "What would break if I change the User model?"

License

MIT