Requirements

  • A supported LLM credential (API key or subscription login — see Authentication)
  • For full tooling: git and rg (ripgrep) on PATH
  • Optional sandbox: bwrap on Linux

Install methods

curl -fsSL https://raw.githubusercontent.com/avala-ai/agent-code/main/install.sh | bash
agent --version

Cargo

cargo install agent-code
# installs `agent` to ~/.cargo/bin

Homebrew

brew install avala-ai/tap/agent-code

Prebuilt binaries

Download from GitHub Releases:

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

Docker

docker run --rm -it -v "$PWD":/work -w /work ghcr.io/avala-ai/agent-code

From source

git clone https://github.com/avala-ai/agent-code.git
cd agent-code
cargo build --release -p agent-code
# binary: target/release/agent

Verify

agent --version
agent -p "reply with only: ok" --permission-mode allow

Uninstall

# curl installer / manual
rm "$(which agent)"

# Cargo
cargo uninstall agent-code

# Homebrew
brew uninstall agent-code

Interactive uninstall helper: agent → /uninstall (when available in your build).

Data locations

WhatPath
User config~/.config/agent-code/config.toml
Sessions~/.config/agent-code/sessions/
Memory~/.config/agent-code/memory/
Skills~/.config/agent-code/skills/
Plugins~/.config/agent-code/plugins/
History~/.local/share/agent-code/history.txt
Tool / task cache~/.cache/agent-code/

Project overlays often live under .agent/ in the repo (skills, agents, team memory).

Next