cast-code

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).

cast não encontrado após instalar?

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)

• Instale o Figma Desktop e abra um arquivo em Dev Mode
• No painel Inspect → ative "Enable desktop MCP server"
• No Cast: /mcp add → Design → Figma Desktop
• 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/