Projetos, MCPs e skills

Cada projeto pode ter um .clawos/project.yaml — versionável no git do projeto e editável pela tela de configurações (menu ⋯ do projeto → Configurações, ou ⌘⇧,).

Exemplo completo

name: Minha loja
defaultAgent: claude
instructions: ./CLAUDE.md
skills:
  - ./.agents/skills/revisao-pr
mcpServers:
  supabase:
    command: npx
    args: ["-y", "@supabase/mcp-server-supabase", "--read-only"]
    env:
      SUPABASE_ACCESS_TOKEN: ${secret:supabase_token}
  docs:
    type: http
    url: https://exemplo.com/mcp
    headers:
      Authorization: Bearer ${secret:docs_token}
agents:
  claude: { enabled: true, inheritUserConfig: false }
  codex: { enabled: true }
  gemini: { enabled: false }

MCPs

Declare servidores stdio (comando local) ou remotos (http / sse). Use o botão Testar para conectar e listar as ferramentas na hora.

Isolamento: as sessões de um projeto enxergam somente os MCPs dele. Os MCPs globais da sua máquina são desligados por sessão — no Claude, no Gemini e também no Codex (inclusive plugins e conectores do ChatGPT), sem alterar a sua configuração. O Codex não suporta MCPs via SSE.

Segredos

Valores sensíveis entram como ${secret:nome}. Defina-os na aba Segredos: eles são criptografados pelo sistema operacional e ficam só neste computador — nunca no YAML nem no git. Se faltar um segredo, a sessão avisa qual.

Skills

Liste pastas com SKILL.md. Prefira .agents/skills/, lida por Claude, Codex e Gemini. Claude e Codex também recebem skills de outras pastas; o Gemini só lê .agents/skills e .gemini/skills dentro do projeto.

Instruções

Cada agente lê o seu arquivo nativo na raiz (CLAUDE.md, AGENTS.md, GEMINI.md). Se instructions apontar para outro arquivo, o Clawos o entrega a todos os agentes do projeto.

Agentes

Em agents, ligue ou desligue agentes para o projeto e escolha o padrão em defaultAgent. inheritUserConfig: true faz o Claude carregar também a sua configuração global (~/.claude: CLAUDE.md, skills e permissões); desligado, o projeto fica isolado.

O Clawos cria .clawos/.gitignore com local/ e gera qualquer outro arquivo fora do seu repositório.