agent-code 0.2.1

An AI-powered coding agent for the terminal, written in pure Rust
---
title: "Installation"
description: "All the ways to install agent-code"
---

## Requirements

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

## Install methods

### Cargo (recommended)

If you have Rust installed:

```bash
cargo install agent-code
```

This installs the `rc` binary to `~/.cargo/bin/`.

### Homebrew

On macOS or Linux:

```bash
brew install avala-ai/tap/agent-code
```

### Prebuilt binaries

Download from [GitHub Releases](https://github.com/avala-ai/agent-code/releases):

| Platform | Architecture | Download |
|----------|-------------|----------|
| Linux    | x86_64      | `rc-linux-x86_64.tar.gz` |
| Linux    | aarch64     | `rc-linux-aarch64.tar.gz` |
| macOS    | x86_64      | `rc-macos-x86_64.tar.gz` |
| macOS    | Apple Silicon| `rc-macos-aarch64.tar.gz` |

```bash
# Example: macOS Apple Silicon
curl -L https://github.com/avala-ai/agent-code/releases/latest/download/rc-macos-aarch64.tar.gz | tar xz
sudo mv agent /usr/local/bin/
```

### From source

```bash
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

```bash
rc --version
# rc 0.1.1
```

Run the environment check:

```bash
rc --dump-system-prompt | head -5
# You are an AI coding agent...
```

## Uninstall

```bash
# 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/` |