Requirements
- A supported LLM API key (Anthropic, OpenAI, or any compatible provider)
gitandrg(ripgrep) for full functionality
Install methods
Cargo (recommended)
If you have Rust installed:
cargo install agent-code
This installs the agent binary to ~/.cargo/bin/.
Homebrew
On macOS or Linux:
brew install avala-ai/tap/agent-code
Prebuilt binaries
Download from GitHub Releases:
| Platform | Architecture | Download |
|---|---|---|
| Linux | x86_64 | agent-linux-x86_64.tar.gz |
| Linux | aarch64 | agent-linux-aarch64.tar.gz |
| macOS | x86_64 | agent-macos-x86_64.tar.gz |
| macOS | Apple Silicon | agent-macos-aarch64.tar.gz |
| Windows | x86_64 | agent-windows-x86_64.zip |
# Example: macOS Apple Silicon
curl -L https://github.com/avala-ai/agent-code/releases/latest/download/agent-macos-aarch64.tar.gz | tar xz
sudo mv agent /usr/local/bin/
From source
git clone https://github.com/avala-ai/agent-code.git
cd agent-code
cargo build --release
sudo cp target/release/agent /usr/local/bin/
Verify installation
agent --version
# agent 0.1.1
Run the environment check:
agent --dump-system-prompt | head -5
# You are an AI coding agent...
Uninstall
# Cargo
cargo uninstall agent-code
# Homebrew
brew uninstall agent-code
# Manual
rm $(which agent)
Data locations
| What | Path |
|---|---|
| User config | ~/.config/agent-code/config.toml |
| Session data | ~/.config/agent-code/sessions/ |
| Memory | ~/.config/agent-code/memory/ |
| Skills | ~/.config/agent-code/skills/ |
| Plugins | ~/.config/agent-code/plugins/ |
| Keybindings | ~/.config/agent-code/keybindings.json |
| History | ~/.local/share/agent-code/history.txt |
| Tool output cache | ~/.cache/agent-code/tool-results/ |
| Task output | ~/.cache/agent-code/tasks/ |