Ir para o conteúdo

Primeiros passos

Esta página leva cerca de cinco minutos. Ao final, o Curupira observa um repositório e entrega toda issue com a label agent-ready ao Claude Code. Troque o agente ou a label pelos seus.

Você precisa do Git, da GitHub CLI (gh) e de uma CLI de agente de código em que você já esteja logado. A Instalação cobre todas as plataformas e opções.

1. Instale e faça login

uv tool install curupira
gh auth login

pip install curupira
gh auth login

npm install -g @caipora-labs/curupira
gh auth login

O conector do GitHub é um plugin que o Curupira inicia via uvx, então você também precisa do uv no PATH. Nada mais é instalado antes.

2. Escreva ~/.curupira/settings.toml

[repositories.api]
remote = "https://github.com/acme/api.git"   # (1)!

[agents.defaults]
profile = "claude"
timezone = "UTC"

[agents.profiles.claude]
provider = "claude"                           # (2)!

[plugins.plugins-py]                          # (3)!
type = "uvx"
args = ["--from", "curupira-plugins", "curupira-plugins"]

[automations.resolve-ready-issues]
trigger_type = "plugins-py/github-issues"     # (4)!
repository = "api"
repo = "acme/api"
labels = ["agent-ready"]
prompt = """
Resolve issue #${issue_number}: ${issue_title}

${issue_body}
"""
  1. Onde o agente trabalha. O Curupira o clona uma vez e dá a cada tarefa o seu próprio worktree.
  2. Qualquer agente suportado: codex, gemini, opencode e outros.
  3. Registra o conector do GitHub sob o alias plugins-py. Os outros conectores são registrados da mesma forma.
  4. <alias>/<trigger>: o trigger de issues do conector registrado acima. repo e labels são os filtros dele, e ${issue_number} e os outros campos preenchem o prompt.

3. Verifique, visualize, execute

curupira validate      # o arquivo está correto?
curupira run --dry-run # qual tarefa rodaria, e o prompt exato que o agente recebe
curupira run --watch   # continua consultando e executa as tarefas conforme aparecem

Pode repetir sem medo

--dry-run não clona nada e não inicia nenhum agente. Use-o enquanto ajusta os filtros e o prompt.

Próximos passos