coddy-agent

# Coddy Agent

A **ReAct (Reasoning + Acting)** AI coding agent written in Go, compatible with any
[Agent Client Protocol (ACP)](https://agentclientprotocol.com/) editor such as Cursor, Zed,
or any other ACP client.

## Features

- **ReAct loop** - LLM alternates between thinking, acting (tool calls), and observing results
- **Two operating modes** - `agent` (full tool access) and `plan` (planning + text files only)
- **Cursor rules support** - reads `.cursor/rules/` and skills just like Cursor IDE
- **MCP server integration** - connect any MCP server for additional tools
- **Multi-provider LLM** - OpenAI, Anthropic, Ollama, any OpenAI-compatible API
- **ACP protocol** - works with Cursor, Zed, and other ACP-compatible editors

## Quick Start

### Installation

```bash
go install github.com/EvilFreelancer/coddy-agent/cmd/coddy@latest
```

Or build and install manually from source:

```bash
git clone https://github.com/EvilFreelancer/coddy-agent
cd coddy-agent
make install
```

`make install` builds the binary and copies it to the appropriate location:
- root - `/usr/local/bin/coddy`
- regular user - `~/.local/bin/coddy`

To only build without installing:

```bash
make build
# or manually:
go build -ldflags "-X github.com/EvilFreelancer/coddy-agent/internal/version.Version=$(git describe --tags --always)" -o coddy ./cmd/coddy/
```

### Terminal UI

![Coddy TUI demo](assets/demo.gif)

Run `coddy` in any project directory to open the interactive terminal UI:

```bash
coddy
```

The TUI opens full-screen with a chat interface. Your session is automatically saved on exit (`ctrl+c`) and can be resumed later:

```bash
coddy -s tui_1234567890   # resume a saved session
```

**Key bindings:**

| Key | Action |
|-----|--------|
| `tab` | Switch mode (agent / plan) |
| `ctrl+p` | Command palette with search |
| `ctrl+m` | Switch model from the list in config |
| `ctrl+x` | Toggle input on/off |
| `esc` | Cancel the running agent |
| `ctrl+c` | Save session and exit |

### Conf