Referência do CLI gamedev
Todos os comandos e opções do CLI gamedev: modos interativo e headless, pkg, remote, daemon, acp, image-runtime, update e slash commands.
O CLI gamedev é o agente do AI Game Dev no seu terminal: a mesma conta, modelos, pacotes e conexão com a engine do app desktop. Esta referência lista todos os comandos e opções do CLI, os slash commands que você digita dentro dele e seus códigos de saída. Instale com npm install -g @baizor/gamedev (veja Instalação).
Uso em resumo
gamedev [<project-dir>] [options] interactive terminal UI
gamedev --print "<prompt>" headless one-shot query, reply on stdout
gamedev --print - headless, prompt read from stdin
gamedev --headless headless, prompt read from stdin
gamedev update upgrade the CLI to the latest version
gamedev pkg <subcommand> [args] manage packages, then exit
gamedev image-runtime [status|start] the local image runtime
gamedev remote <subcommand> [args] remote access and your other devices
gamedev daemon <subcommand> the background service
gamedev --on <name|id-prefix> the terminal UI on another computer's chats
gamedev acp [--model <model>] Agent Client Protocol agent on stdin/stdout
gamedev --help | --versionOpções
| Opção | Significado |
|---|---|
<project-dir> | Pasta do projeto (o mesmo que --project); um caminho relativo é resolvido a partir do diretório atual |
--project, -p <path> | Pasta do projeto (padrão: o diretório atual) |
--cwd <path> | Alias para --project |
--model <model> | Modelo a usar (padrão: o atribuído à sua conta) |
--resume, -r <id> | Retoma uma sessão anterior |
--print <prompt> | Não interativo: envia o prompt, transmite a resposta para stdout e sai. - lê da entrada padrão |
--headless | Força o modo não interativo, com prompt a partir da entrada padrão |
--on <name> | Abre a interface de terminal nos chats de outro computador pareado |
--help, -h | Mostra a ajuda |
--version, -v | Imprime a versão |
--project e --cwd têm precedência sobre uma pasta posicional.
Modo interativo
Execute gamedev em uma pasta de projeto. Digite um pedido e pressione Enter. Teclas úteis:
/abre a paleta de slash commands; as setas navegam e Tab completa o nome do comando.- Esc durante o streaming de uma resposta a interrompe.
- Ctrl+C sai (pressione duas vezes para confirmar).
- Segure Espaço por cerca de um terço de segundo no campo de entrada para falar (entrada de voz push-to-talk).
Sem um terminal (entrada via pipe), o CLI recorre a um modo de linha simples.
Modo headless e scripts
Execuções headless imprimem apenas a resposta em stdout; o que o CLI detectou (por exemplo, "Unity project detected") vai para stderr.
gamedev --print "List every scene in this project"
echo "Summarise the open TODOs in Assets/Scripts" | gamedev --headless
gamedev --project ./MyGame --model <model-id> --print "Run the edit-mode tests"| Código de saída | Quando |
|---|---|
0 | A resposta terminou |
1 | Um erro de consulta, de rede ou do agente, ou Ctrl+C depois que a execução começou |
2 | Não está conectado, prompt vazio, ou pasta ou flag inutilizável |
130 | Ctrl+C antes de a execução começar; nada foi enviado |
143 | SIGTERM; o CLI se desanexa e um prompt já enviado continua rodando no serviço em segundo plano |
gamedev pkg
Gerencie os pacotes do projeto no diretório atual (ou --cwd <path>). Flags de nível: --user (todos os projetos deste computador), --project (versionado, o padrão), --local (apenas este checkout).
gamedev pkg list [--user] packages in effect (--user: the user level alone)
gamedev pkg add <input> [level] <publisher.name>[@range] | github:<owner>/<repo>[@tag|#ref] | npm:<name> | file:<path> | URL | owner/repo | folder
gamedev pkg remove <id> [level] delete the id's entry at that level
gamedev pkg exclude <id> [level] turn the package off at that level
gamedev pkg include <id> [level] undo exclude
gamedev pkg update [<id>] [--user] newest compatible version within the declared range, now
gamedev pkg auto-update on|off <id> this computer's auto-update preference for one package
gamedev pkg sync [--user] make locks and cache match the level files
gamedev pkg link <folder> [level] use a local folder instead of the published version (default --local)
gamedev pkg unlink <id> [level] stop using the local folder
gamedev pkg dev <folder> [level] link, and rebuild on every source change until Ctrl+C
gamedev pkg settings <id> [<key> [<value>]] read or write a package's settings (--unset clears a value)gamedev pkg settings sai com código 1 quando um valor é recusado e 2 em erro de uso. Veja Criando pacotes para link e dev.
gamedev image-runtime
gamedev image-runtime status [--json] show this computer's local image runtime coordinator
gamedev image-runtime start [--json] start it through the background serviceOs próprios modelos são gerenciados com /images dentro do CLI (abaixo).
gamedev remote
Acesso remoto entre seus computadores e dispositivos conectados à mesma conta. /remote no CLI interativo é o mesmo comando.
gamedev remote status this computer and your other devices
gamedev remote pair show a pairing code and QR, then approve the device that enters it
gamedev remote join <device> <code> pair with another computer
gamedev remote allow [<device>] allow remote control here, or let a device control chats
gamedev remote allow <device> --services let a device use this computer's shared models
gamedev remote block [<device>] [--services] turn remote control off, or take a device's access away
gamedev remote share [on|off] share this computer's models with your other computers
gamedev remote share pause|resume stop or resume accepting images from other computers
gamedev remote forget <device> unpin a computer you paired with
gamedev remote revoke <device> remove a device paired with this computer
gamedev remote rename <name> the name your other devices seeUm dispositivo é um nome ou o início do seu id. pair pergunta separadamente sobre visualização, controle e modelos compartilhados. Depois, gamedev --on <device> abre os chats daquele computador; /machine lista ou alterna computadores e /machine this volta.
gamedev daemon
O serviço em segundo plano compartilhado pelo app desktop e pelo CLI.
gamedev daemon status installed and running; the Kernel, account, remote access, logs
gamedev daemon install run it as a per-user OS service that starts at login and restarts if it stops
gamedev daemon uninstall remove the OS service
gamedev daemon start start the background service
gamedev daemon stop stop it
gamedev daemon restart stop, then start
gamedev daemon logs [kernel|service|remote|auth] [--lines N] [--follow]O serviço do sistema operacional é um LaunchAgent no macOS, uma unit de usuário do systemd no Linux e uma tarefa do Agendador de Tarefas no logon no Windows; não exige direitos de administrador.
gamedev acp
gamedev acp transforma o CLI em um agente Agent Client Protocol para clientes ACP como T3 Code, Zed e IDEs JetBrains. O cliente o inicia; as mensagens do protocolo usam stdout e o diagnóstico vai para stderr. No cliente, adicione um agente personalizado com o comando gamedev e o argumento acp. Ele usa o login deste computador, os modelos da sua conta e as ferramentas de engine do projeto. O post AI Game Dev como agente ACP no T3 Code mostra a configuração passo a passo.
Slash commands
Digite estes comandos dentro do CLI interativo. Muitos também funcionam no chat do desktop.
Chat e sessão
| Comando | O que faz |
|---|---|
/help | Lista os comandos disponíveis |
/clear | Inicia uma nova conversa |
/reset | Redefine a sessão atual |
/reopen | Reabre um chat perdido a partir do histórico salvo (nada é reenviado) |
/saved | Recupera mensagens, configurações, imagens e alterações de arquivo ou Git salvas |
/model | Escolhe o modelo (Tab: esforço de raciocínio) |
/agent | Lista os agentes; /agent use <id> alterna, /agent refresh recarrega a lista |
/skills | Lista as skills disponíveis neste projeto |
/context | Alterna o painel de depuração de contexto |
/exit | Sai (também /quit) |
Conta, configurações e atualizações
| Comando | O que faz |
|---|---|
/login [--switch] | Faz login; --switch troca a conta deste computador |
/logout | Faz logout |
/config | Configurações, incluindo as Ferramentas desta sessão |
/permissions | Mostra ou altera quando a IA pergunta antes de executar ferramentas |
/voice-language | Define o idioma de transcrição de voz |
/update [now] | Como atualizar o CLI; now atualiza um serviço em segundo plano que está aguardando |
/remote, /machine | Acesso remoto; lista ou alterna computadores |
Engine e projeto
| Comando | O que faz |
|---|---|
/install-plugin [path] | Instala o plugin MCP no projeto Unity, Godot ou Unreal atual |
/install-extension | Navega e instala uma extensão de engine |
/open | Abre o editor do projeto atual |
/create-project | Cria um novo projeto de jogo, por exemplo /create-project unity MyGame (engine unity, godot ou unreal, um nome e uma pasta pai opcional) |
/file | Cria, renomeia, move, copia ou exclui arquivos do projeto |
/files [n] | Lista os arquivos mencionados neste chat; abra um deles |
/search, /replace | Pesquisa no projeto; salva, aplica e recupera Search Replace |
/git | Status, stage, commit, descartar, pull, push, force-push e init |
Extensões, pacotes e modelos
| Comando | O que faz |
|---|---|
/packages | Os mesmos subcomandos de gamedev pkg, mais views, tree <view id>, runs, cancel e reload |
/mcp | Gerencia os servidores MCP do projeto: adicionar, ativar, remover, testar |
/plugin | Gerencia plugins e marketplaces do Claude: instalar, ativar, atualizar |
/images | Modelos de imagem locais, downloads e armazenamento (/images help) |
/image [n] | Lista as imagens desta sessão; abra ou remova uma |
/models | Todas as formas de executar um modelo de mídia, local e na nuvem; adicione image, video, audio ou 3d (/models help) |
/cloud | A configuração de geração na Nuvem desta sessão: ask, budget <percent> ou off |
/blender, /supercollider, /kb | Comandos dos pacotes Blender, Music e Knowledge Base |
Pacotes instalados podem adicionar mais slash commands; eles aparecem na paleta /.
Subcomandos de /images
/images this computer, the runtime, storage and every image model
/images download <model> [--yes] download a model (and the runtime when missing); asks first
/images cancel|resume <model|runtime> stop or continue a download
/images update <model> [--yes] download a model's update
/images delete <model> [--yes] delete a model's files from this computer
/images allow|block <model> [--user|--project] whether the agent may use it
/images default <model|auto> the default image model (auto = recommended for this computer)
/images stop [session|<job id>] stop image generation and free the GPU
/images free-space [--yes] delete model files no model uses any more
/images storage [<new folder>] show or move the model storage folder
/images redetect detect the GPU, memory and driver again
/images reinstall set the image runtime up againVariáveis de ambiente
| Variável | Finalidade |
|---|---|
AI_GAME_DEV_MODEL | Substituição do modelo padrão |
AI_GAME_DEV_ASCII_GLYPHS | 1 força medidores ASCII no seletor /model para terminais que medem emoji incorretamente |
Prioridade de configuração: opções de linha de comando, depois variáveis de ambiente, depois ~/.ai-game-dev/config.json.
Relacionado
- Os plugins de engine têm seus próprios CLIs:
unity-mcp-cli,unreal-mcp-cli,godot-cli. - Solução de problemas para erros e códigos de saída na prática.