# Referência do CLI gamedev — App e CLI do AI Game Dev · AI Game Developer Wiki

Todos os comandos e opções do CLI gamedev: modos interativo e headless, pkg, remote, daemon, acp, image-runtime, update e slash commands.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/app/cli).

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](https://ai-game.dev/pt-br/docs/wiki/app/installation#cli)).

## Uso em resumo

```text
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 | --version
```

## Opçõ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.

```bash
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](https://ai-game.dev/pt-br/docs/wiki/app/packages) 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).

```text
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](https://ai-game.dev/pt-br/docs/wiki/app/creating-packages#develop) para `link` e `dev`.

## gamedev image-runtime

```text
gamedev image-runtime status [--json]    show this computer's local image runtime coordinator
gamedev image-runtime start [--json]     start it through the background service
```

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

```text
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 see
```

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

```text
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](https://ai-game.dev/pt-br/blog/acp-agent-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

```text
/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 again
```

## Variá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`](https://ai-game.dev/pt-br/docs/wiki/unity/cli), [`unreal-mcp-cli`](https://ai-game.dev/pt-br/docs/wiki/unreal/cli), [`godot-cli`](https://ai-game.dev/pt-br/docs/wiki/godot/cli).
- [Solução de problemas](https://ai-game.dev/pt-br/docs/wiki/app/troubleshooting) para erros e códigos de saída na prática.

---

Source (HTML): https://ai-game.dev/pt-br/docs/wiki/app/cli

Machine-translated (pt-BR) from the English page: https://ai-game.dev/docs/wiki/app/cli