Cast Code

Uma CLI multi-agente que pensa, planeja e escreve código junto com você — direto no seu terminal.

Cast é um assistente autônomo de IA para engenheiros. Ele lê o codebase, delega para sub-agentes especialistas, escreve e edita arquivos, gera commits, cria PRs e se conecta a ferramentas externas via MCP — tudo com um único comando cast.

Feito por pedrocastanha. Inspirado no Claude Code, OpenAI Codex e Kimi.

Instalação

npm install -g cast-code
cast

Requer Node.js ≥ 20. Funciona no Linux e macOS (bash, zsh, fish e qualquer shell POSIX).

O diretório global de binários do npm pode não estar no seu PATH. Descubra com npm prefix -g e adicione <prefix>/bin ao seu shell:

| Shell | Arquivo | Linha | |---|---|---| | bash | ~/.bashrc ou ~/.bash_profile | export PATH="$(npm prefix -g)/bin:$PATH" | | zsh | ~/.zshrc | export PATH="$(npm prefix -g)/bin:$PATH" | | fish | ~/.config/fish/config.fish | fish_add_path (npm prefix -g)/bin |

Recarregue o shell e rode cast.

O que o Cast faz

| Capacidade | Como | |---|---| | Explorar e entender o codebase | Lê arquivos, busca padrões, mapeia a estrutura | | Escrever, editar e refatorar código | Ciclo completo: leitura → plano → escrita → verificação | | Gerar commits semânticos | /up — IA lê o diff e escreve a mensagem | | Dividir commits inteligentemente | /split-up — agrupa mudanças por intenção lógica | | Criar descrições de pull request | /pr — gera corpo de PR com contexto rico | | Revisar código | /review [arquivos] — aponta problemas com contexto | | Delegar para agentes especialistas | coder, architect, reviewer, frontend, backend, devops, tester | | Acompanhar sub-agentes ao vivo | Árvore no terminal com status, ferramenta atual e tempo de cada agente | | Escrever mensagens multilinha | Ctrl+J ou \ + Enter em qualquer terminal; Shift+Enter em kitty/WezTerm/Ghostty | | Conectar a 30+ ferramentas externas | MCP — Figma, GitHub, bancos de dados, browser e mais | | Trabalhar pelo celular | /remote — interface web segura via ngrok com entrada por voz | | Usar CLIs assinadas sem API key | /bridge — roda o Cast por Claude, Codex, Kimi, Qwen, Copilot ou OpenRouter CLI |

Providers

O Cast funciona com qualquer um destes:

| Provider | Variável de ambiente | |---|---| | OpenAI (GPT-4.1, o3…) | OPENAI_API_KEY | | Anthropic (Claude 4) | ANTHROPIC_API_KEY | | Google (Gemini 2.5) | GOOGLE_API_KEY | | Ollama (modelos locais) | (sem chave) |

Você pode atribuir modelos diferentes por papel — default, subAgent, coder, architect, reviewer, planner, cheap — para equilibrar custo e qualidade por tarefa.

Configure com /config init ou edite ~/.cast/config.yaml diretamente.

Bridge de provider CLI

Se você assina um modelo por plano e não tem uma API key para colocar no Cast, use o bridge:

cast bridge claude

Ou dentro do REPL:

/bridge
/bridge claude
/bridge autostart claude
/bridge status
/bridge tools
/bridge stop

Providers aceitos pelo bridge: claude, codex, copilot, qwen, kimi, openrouter.

No REPL, /bridge abre um seletor de providers. Use ↑/↓ para escolher, Enter para conectar agora, ou Tab para conectar e ativar autostart no projeto atual. O seletor também tem Stop bridge, que desconecta o bridge e volta para o runtime normal por API key. Depois de /bridge <provider>, prompts normais sem / são enviados para a CLI conectada até você rodar /bridge stop ou escolher Stop bridge no menu. O bridge troca apenas o runtime do modelo. O Cast continua controlando ferramentas locais, permissões, transcripts e guardrails de arquivos/shell. Isso é diferente de /remote, que só expõe a interface web do Cast para outro dispositivo.

Autostart é opt-in e fica em .cast/bridge.json. Use /bridge autostart off para desligar.

Para CLIs diferentes do padrão, configure comando e argumentos por provider:

CAST_BRIDGE_QWEN_COMMAND=qwen-code
CAST_BRIDGE_QWEN_ARGS="--some-flag"
cast bridge qwen

Claude usa stream-json por padrão quando nenhum override é definido. Para validar consumo real com limite de orçamento:

CAST_BRIDGE_CLAUDE_MAX_BUDGET_USD=0.10 cast bridge claude

Codex usa codex exec --json por padrão, em modo one-shot, com stdin fechado depois do prompt e sem carregar user config/rules do Codex. Isso evita abrir a TUI do Codex dentro do bridge.

Se uma CLI real demorar no primeiro token, ajuste CAST_BRIDGE_TURN_FIRST_BYTE_MS; depois do primeiro chunk, CAST_BRIDGE_TURN_IDLE_MS controla o fim do turno.

Comandos

Core

| Comando | O que faz | |---|---| | /help | Mostra todos os comandos | | /init | Analisa o projeto e gera contexto | | /project-deep | Contexto profundo + briefing para agente especialista | | /context | Sessão atual: ferramentas, agentes, skills, MCP | | /clear | Limpa o histórico da conversa | | /compact | Comprime o contexto para economizar tokens | | /stats | Uso de tokens e custo da sessão | | /kanban | Abre o quadro Kanban (localhost:3333) | | /remote | Expõe interface web via ngrok | | /bridge | Escolhe provider CLI com setas; Tab conecta e ativa autostart; Stop bridge volta à API key | | /bridge <provider> | Usa o Cast através de um provider CLI autenticado | | /bridge autostart <provider>\|off | Liga/desliga autostart do bridge no projeto | | /bridge status | Mostra status, provider, tools e modo raw do bridge | | /bridge stop | Desconecta o bridge e volta ao runtime normal do Cast | | /exit | Sair |

Git

| Comando | O que faz | |---|---| | /status, /diff, /log | Status, diff, log do git | | /up | Mensagem de commit gerada por IA → confirmar → push | | /split-up | Divide mudanças em commits lógicos | | /pr | Gera título + descrição de PR | | /review [arquivos] | Revisão de código por IA | | /fix <arquivo> | Corrige problemas automaticamente em um arquivo | | /release [tag] | Gera notas de release | | /unit-test | Gera testes para as mudanças da branch |

Agentes & Skills

| Comando | O que faz | |---|---| | /agents | Lista todos os agentes especialistas | | /agents create | Cria um agente customizado | | /skills | Lista todas as skills | | /skills create | Cria uma skill customizada |

Config & MCP

| Comando | O que faz | |---|---| | /config | Menu de configuração | | /mcp list | Lista os servidores MCP configurados | | /mcp add | Adiciona um servidor (30+ templates ou customizado) |

Platform

| Comando | O que faz | |---|---| | cast platform --project <id> | Vincula o diretório atual a um projeto remoto da Cast Platform | | /platform | Configura API URL, key global e projeto atual pela interface do CLI | | /platform --project <id> | Vincula direto, sem sair do chat | | /platform status | Mostra projeto, API URL, env var da key e status do RAG sem expor segredo |

Injeção de contexto com @

Mencione qualquer arquivo, diretório ou fonte de dados para injetá-lo direto no seu prompt:

@src/auth/service.ts           → injeta o conteúdo do arquivo
@src/components/               → injeta a listagem do diretório
@git:status                    → injeta o git status atual
@git:diff                      → injeta o diff atual
@https://docs.example.com      → busca e injeta a URL

Sistema multi-agente

O Cast vem com 7 agentes especialistas built-in:

• coder — implementação de propósito geral
• architect — design de sistema e decisões de arquitetura
• reviewer — revisão de código e verificação de qualidade
• frontend — implementação de UI/UX
• backend — trabalho em APIs e lado do servidor
• devops — infraestrutura e deployment
• tester — geração de testes e garantia de qualidade

O Cast roteia as tarefas para o agente certo automaticamente, ou você pode endereçá-los diretamente. Adicione seus próprios agentes em .cast/agents/ em qualquer projeto.

MCP — Model Context Protocol

O Cast integra com 30+ ferramentas externas via MCP em diversas categorias:

Dev Tools · GitHub · GitLab · Jira · Linear Design · Figma Desktop · Storybook Dados · PostgreSQL · MySQL · SQLite · Redis Busca · Brave · Perplexity · Exa Cloud · AWS · Vercel · Cloudflare Produtividade · Slack · Notion · Google Drive Browser · Playwright · Puppeteer

Figma Desktop (recomendado para frontend)

1. Instale o Figma Desktop e abra um arquivo em Dev Mode
2. No painel Inspect → ative "Enable desktop MCP server"
3. No Cast: /mcp add → Design → Figma Desktop
4. Reinicie o Cast — agora você pode pedir ao Cast para implementar componentes direto dos seus designs no Figma

Para servidores HTTP que exigem OAuth, o Cast gerencia o fluxo completo de OAuth 2.0 + PKCE automaticamente.

Acesso remoto

O Cast pode servir uma interface web protegida por senha — acessível pelo celular, tablet ou qualquer máquina remota.

/remote

🌐 Remote Access Online!
Link:     https://xxxx.ngrok-free.app
Password: sua-senha

Suporta streaming de saída em tempo real, envio de prompts pelo browser e entrada por voz via Whisper.

Modo de planejamento

Para tarefas complexas o Cast entra em modo de planejamento — faz perguntas de esclarecimento, propõe um plano estruturado e só executa após sua aprovação. Você pode refinar, rejeitar ou simplesmente dizer "vai" para prosseguir sem plano.

Stack técnica

• Runtime: Node.js ≥ 20, TypeScript
• Framework: NestJS (DI, modular)
• Orquestração: LangChain + LangGraph (multi-agente, streaming)
• MCP: @modelcontextprotocol/sdk (stdio + HTTP/SSE, OAuth 2.0 + PKCE)
• Providers: Anthropic, OpenAI, Google Gemini, Ollama
• Config: YAML em ~/.cast/config.yaml

Estrutura dos módulos

src/modules/
  repl/        CLI interativa, comandos, SmartInput, autocomplete
  core/        agente principal, system prompt, modo de plano, streaming
  agents/      sub-agentes especialistas
  skills/      definições de skills e carregamento de conhecimento
  mcp/         cliente MCP, OAuth, registro de servidores, 30+ templates
  git/         geração de commits, split-commit, PR, revisão, release
  project/     análise de projeto e geração de contexto
  tools/       ferramentas de filesystem, shell, busca, web
  config/      configuração de providers e modelos
  mentions/    injeção de contexto via @-mention
  stats/       rastreamento de tokens e custo da sessão
  platform/    link com Cast Platform, skills/agents remotos, cache e telemetria segura
  bridge/      ponte para CLIs autenticadas de providers externos

Cast Platform CLI

O CLI pode ser vinculado a um projeto remoto sem armazenar secrets no repositório:

export CAST_API_KEY="csk_..."
cast platform --project <project-id>

Isso cria ou atualiza .cast/cast.yaml:

version: 1
platform:
  projectId: "uuid-do-projeto"
  apiKeyEnv: "CAST_API_KEY"
  apiUrl: "https://api.castplatform.dev"

O Cast puxa skills e agents remotos no boot, mas as versões locais em .cast/skills/ e .cast/agents/ sempre têm prioridade. Se a API estiver offline, o CLI usa .cast/platform.cache.json quando disponível e continua local-only quando não houver cache.

Telemetria envia apenas metadados de sessão, comandos e tokens. Prompts, outputs, conteúdo de arquivos, diffs, stdout/stderr e valores de API key nunca são enviados.

Desenvolvimento local

npm install
npm run build
npm run start       # executa uma vez
npm run start:dev   # modo watch (recompila ao salvar)

Dicas

• Rode /init ao começar em um novo projeto — ele mapeia o codebase para o contexto
• Mantenha .cast/context.md atualizado com notas específicas do projeto
• Use /compact quando a sessão ficar longa para evitar atingir os limites de tokens
• Rode /context para verificar o que o Cast está vendo no momento
• Agentes e skills no nível do projeto ficam em .cast/agents/ e .cast/skills/