Requirements

  • A supported LLM API key (Anthropic, OpenAI, or any compatible provider)
  • git and rg (ripgrep) for full functionality

Install methods

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:

PlatformArchitectureDownload
Linuxx86_64agent-linux-x86_64.tar.gz
Linuxaarch64agent-linux-aarch64.tar.gz
macOSx86_64agent-macos-x86_64.tar.gz
macOSApple Siliconagent-macos-aarch64.tar.gz
Windowsx86_64agent-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

WhatPath
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/