Pular para o conteúdo
Octopus — configuração centralizada de AI agents

Octopus

Configuração centralizada de AI coding agents para times multi-repo. Skills, bundles, hooks, roles e continuous learning — uma única fonte de verdade que atende Claude Code, Codex, Copilot, Gemini e OpenCode.

O problema

Todo time que adota um AI coding agent em escala acaba escrevendo o mesmo tipo de configuração várias vezes: as convenções de código do projeto, as convenções de commit do time, os guardrails de segurança, os playbooks de on-call, os rituais de post-mortem. Essa config vira tribal: um CLAUDE.md longo, uma pasta de .cursor/rules/*, um copilot-instructions.md pela metade. Cada agent fala um dialeto diferente da mesma ideia.

O Octopus é a camada de configuração que fica acima de todos eles. Uma única fonte de verdade — bundles, skills, hooks, roles, knowledge — que compila para o formato que cada agent espera. Adicionar um agent novo, mudar uma coding rule, lançar um audit novo: uma edição só, todas as superfícies atualizadas.

Os cinco primitivos

  • Bundles — pacotes opinados de skills + roles + rules afinados para um arquétipo de time (starter, quality, docs, backend, growth).
  • Skills — protocolos que o agent engaja por match de descrição ou invocação explícita (debug, doc-prd, refactor-deepen, audit-config, mais 30+).
  • Commands — slash commands que fixam uma skill específica em uma invocação tipada (/octopus:debug, /octopus:context-handoff, …).
  • Hooks — scripts de ciclo de vida que reforçam disciplina automaticamente: formatar ao salvar, bloquear git destrutivo, propor updates no CLAUDE.md no fim da sessão.
  • Roles — personas para as quais o usuário pode delegar (@architect, @backend-developer, @writer, …) que escopam o comportamento do agent para uma tarefa.

Instalar

macOS / Linux

Terminal window
curl -fsSL https://github.com/leocosta/octopus/releases/latest/download/install.sh | bash

Windows (PowerShell)

Terminal window
irm https://github.com/leocosta/octopus/releases/latest/download/install.ps1 | iex

Depois rode octopus update dentro de qualquer repo para gerar os arquivos de configuração dos agents. Walkthrough completo na página de Início Rápido.

Workflows em destaque