> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Coda

> Code companion that lives in Slack. PR reviews, issue triage, architecture questions.

**Coda is a code companion that lives in Slack and works alongside your team.**

Most engineering work isn't writing code. It's understanding how things work, reviewing PRs, figuring out what broke, triaging the backlog, and deciding what's safe to change. That work happens in Slack and GitHub, not in an editor. Coda fills that gap.

## How It Works

Coda is a team of five specialist agents coordinated by a leader:

| Agent          | Role                                                   |
| -------------- | ------------------------------------------------------ |
| **Explorer**   | Code search, architecture Q\&A, PR reviews (read-only) |
| **Coder**      | Writes code in isolated worktrees, opens PRs           |
| **Planner**    | Breaks features into ordered GitHub issues             |
| **Triager**    | Labels, comments, closes issues based on code analysis |
| **Researcher** | Web search for docs, APIs, error messages              |

**Code isolation:** All code changes happen in git worktrees on `coda/*` branches. Your main branch is never touched. Coda opens PRs; humans merge them.

| Capability            | What It Does                                         |
| --------------------- | ---------------------------------------------------- |
| **Architecture Q\&A** | "How does auth work?" "Where is the model API call?" |
| **PR Reviews**        | Diffs against your conventions, leaves comments      |
| **Issue Triage**      | Reads open issues, flags urgent ones                 |
| **Code Writing**      | Isolated worktrees, never touches main               |

### Self-Learning

Coda improves without retraining through Agno's `LearningMachine`. It picks up your coding standards, conventions, and patterns:

| Week 1                                     | Week 4                                                                                                     |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| Writes working code using generic patterns | Follows your service layer conventions, uses your team's error handling pattern, matches your naming style |

Over time Coda stops waiting to be asked: it reviews open issues on a schedule, flags low-hanging fruit, and proposes changes.

## Run Locally

See [Setup guide](/tutorials/coda/setup) for detailed instructions.

```bash theme={null}
git clone https://github.com/agno-agi/coda.git && cd coda

cp example.env .env
# Edit .env: add OPENAI_API_KEY and GITHUB_ACCESS_TOKEN

docker compose up -d --build
```

Confirm Coda is running at `http://localhost:8000/docs`.

### Configure GitHub Access

Create a GitHub Personal Access Token with repo access and add it to `.env`:

```bash theme={null}
GITHUB_ACCESS_TOKEN="github_pat_***"
```

Then tell Coda which repos to learn by editing `repos.yaml`:

```yaml theme={null}
repos:
  - url: https://github.com/your-org/your-repo
    branch: main
```

### Connect to the Control Plane

1. Open [os.agno.com](https://os.agno.com)
2. Click **Connect OS** → **Local**
3. Enter `http://localhost:8000`

## Connect to Slack

Coda is designed to live in Slack as your teammate. Add your Slack credentials to `.env`:

```bash theme={null}
SLACK_TOKEN="xoxb-***"
SLACK_SIGNING_SECRET="***"
```

Then restart to pick up the credentials:

```bash theme={null}
docker compose restart
```

See [Slack setup](/tutorials/coda/connect-slack) for creating the Slack app.

## Deploy to Railway

See [Deploy to Railway](/tutorials/coda/deploy-to-railway) for JWT setup and production configuration.

```bash theme={null}
railway login
./scripts/railway_up.sh
```

The script provisions PostgreSQL, configures environment variables, and deploys Coda.

Then connect via the control plane:

1. Open [os.agno.com](https://os.agno.com)
2. Click **Connect OS** → **Live**
3. Enter your Railway domain

## Example Prompts

Try these after connecting your repos:

* How does authentication work in this codebase?
* Review the open PR on feature/new-api
* What are the most important open issues?
* Where is the database connection configured?
* What testing conventions does this project use?

## Source

For GitHub access setup, Slack configuration, and architecture details, see the [GitHub repo](https://github.com/agno-agi/coda).