# Adicione a Arroway a um repositório

> Para um agente de código a quem pediram para adicionar a Arroway a este repositório. Com os arquivos abaixo commitados, todo colega e todo agente que abrir o projeto já chega com a Arroway conectada.

## Passos

1. Grave a configuração de MCP de cada ferramenta que este repositório usa, apontando para o endereço público da Arroway: `.mcp.json` no Claude Code, `.cursor/mcp.json` no Cursor, `.codex/config.toml` no Codex. O Codex só lê a configuração do próprio projeto quando o projeto é confiável.
2. Nunca grave no repositório o endereço privado de uma conta pessoal — esse endereço é a identidade da pessoa. No repositório vai só o endereço público; a identidade de cada um vem do próprio login.
3. Acrescente o bloco da Arroway abaixo ao AGENTS.md (ou ao CLAUDE.md) do repositório, trocando <project> pelo projeto da Arroway a que este repositório pertence.
4. Opcional: no Claude Code, o `.claude/settings.json` oferece o plugin da Arroway a todos que abrirem o projeto; o plugin traz a skill e os prompts que tornam automáticas a leitura da abertura e o registro do fechamento. A conexão é obrigatória; o plugin, não.
5. Diga à pessoa o único gesto que é dela: entrar na primeira vez que a ferramenta dela se conectar à Arroway — no Codex, com `codex mcp login arroway`.
6. Confira que uma leitura responde: chame `arroway_read` no projeto. Quando ela devolver as regras do projeto, o repositório está pronto.

## Os arquivos

### `.mcp.json` — Claude Code

```json
{
  "mcpServers": {
    "arroway": {
      "type": "http",
      "url": "https://www.arroway.app/api/mcp"
    }
  }
}
```

### `.cursor/mcp.json` — Cursor

```json
{
  "mcpServers": {
    "arroway": {
      "type": "http",
      "url": "https://www.arroway.app/api/mcp"
    }
  }
}
```

### `.codex/config.toml` — Codex, só em projeto confiável

```toml
[mcp_servers.arroway]
url = "https://www.arroway.app/api/mcp"
```

### `AGENTS.md` — instruções que todo agente lê

```markdown
## Arroway

This repository's decisions live in Arroway, in the project "<project>". Before acting on a task here, call `arroway_read` on that project and use what it returns. When you finish, record what the work settled with `arroway_log`.
```

### `.claude/settings.json` — plugin do Claude Code (opcional)

```json
{
  "extraKnownMarketplaces": {
    "arroway": {
      "source": {
        "source": "github",
        "repo": "oaleviola/arroway-plugin"
      }
    }
  },
  "enabledPlugins": {
    "arroway@arroway": true
  }
}
```

## O que nunca entra no repositório

O endereço privado de uma conta pessoal, senhas, tokens ou chaves de API. Os arquivos acima levam só o endereço público.

Página de instalação para pessoas: https://www.arroway.app/pt-BR/install