agent-code 0.2.1

An AI-powered coding agent for the terminal, written in pure Rust
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

---
title: "Overview"
description: "An AI coding agent that lives in your terminal"
---

# What is agent-code?

agent-code is an open-source, AI-powered coding agent for the terminal. You describe what you want in natural language, and the agent reads your codebase, runs commands, edits files, and iterates until the task is done.

It's built in pure Rust for speed, safety, and a single static binary with zero runtime dependencies.

## What can it do?

<CardGroup cols={2}>
  <Card title="Read and understand code" icon="magnifying-glass">
    Searches your codebase, reads files, traces dependencies, and explains how things work.
  </Card>
  <Card title="Write and edit code" icon="pen">
    Creates files, makes targeted edits, refactors code, adds features, and fixes bugs.
  </Card>
  <Card title="Run commands" icon="terminal">
    Executes shell commands, runs tests, manages git operations, and handles build tools.
  </Card>
  <Card title="Multi-step tasks" icon="diagram-project">
    Chains together reading, writing, and running to complete complex engineering tasks autonomously.
  </Card>
</CardGroup>

## How it works

The core loop is simple:

1. You type a request
2. The agent sends your request + conversation history to an LLM
3. The LLM responds with text and tool calls
4. The agent executes the tools (file reads, edits, shell commands, etc.)
5. Tool results are fed back to the LLM
6. Repeat until the task is done

Every tool call passes through a permission system before executing. You stay in control.

```
You: "add input validation to the signup endpoint"

Agent:
  → FileRead src/routes/signup.rs
  → Grep "validate" src/
  → FileEdit src/routes/signup.rs (add validation logic)
  → Bash "cargo test"
  → FileEdit src/routes/signup.rs (fix test failure)
  → Bash "cargo test"
  ✓ All tests pass. Validation added.
```

## Key features

- **31 built-in tools** for file operations, shell commands, code search, web access, language servers, and more
- **32 slash commands** for git, session management, diagnostics, and agent control
- **Multi-provider support** — works with Anthropic (Claude), OpenAI (GPT), and any OpenAI-compatible endpoint
- **Permission system** with configurable rules per tool and pattern
- **MCP support** for connecting external tool servers
- **Memory system** for persistent context across sessions
- **Skills** for custom reusable workflows
- **Plugin system** for bundling extensions
- **Session persistence** with save and resume
- **Plan mode** for safe read-only exploration
- **Extended thinking** for complex reasoning tasks

## Architecture

```
                        ┌─────────────┐
                        │   CLI / REPL │
                        └──────┬───────┘
                               │
              ┌────────────────▼────────────────┐
              │          Query Engine            │
              │  stream → tools → loop → compact │
              └──┬──────────┬──────────┬────────┘
                 │          │          │
        ┌────────▼──┐ ┌────▼─────┐ ┌──▼───────┐
        │   Tools   │ │ Perms    │ │  Hooks   │
        │  31 built │ │ allow    │ │ pre/post │
        │  + MCP    │ │ deny/ask │ │ shell    │
        └───────────┘ └──────────┘ └──────────┘
```

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get up and running in 2 minutes.
  </Card>
  <Card title="Installation" icon="download" href="/installation">
    All the ways to install agent-code.
  </Card>
</CardGroup>