gamedev CLI-Referenz
Alle gamedev CLI-Befehle und -Optionen: interaktiv, Headless, pkg, remote, daemon, acp, image-runtime, update und die Slash-Befehle im Terminal.
Die gamedev CLI ist der AI Game Dev-Agent in deinem Terminal: dasselbe Konto, dieselben Modelle, Pakete und dieselbe Engine-Verbindung wie die Desktop-App. Diese Referenz listet jeden Befehl und jede Option der CLI, die Slash-Befehle, die du darin eingibst, und ihre Exit-Codes. Installiere sie mit npm install -g @baizor/gamedev (siehe Installation).
Verwendung auf einen Blick
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 | --versionOptionen
| Option | Bedeutung |
|---|---|
<project-dir> | Projektordner (wie --project); ein relativer Pfad wird relativ zum aktuellen Verzeichnis aufgelöst |
--project, -p <path> | Projektordner (Standard: das aktuelle Verzeichnis) |
--cwd <path> | Alias für --project |
--model <model> | Zu verwendendes Modell (Standard: das deinem Konto zugewiesene) |
--resume, -r <id> | Eine frühere Sitzung fortsetzen |
--print <prompt> | Nicht interaktiv: Prompt senden, Antwort nach stdout streamen, beenden. - liest von stdin |
--headless | Nicht-interaktiven Modus erzwingen, Prompt von stdin |
--on <name> | Die Terminal-UI auf den Chats eines anderen gekoppelten Computers öffnen |
--help, -h | Hilfe anzeigen |
--version, -v | Die Version ausgeben |
--project und --cwd haben Vorrang vor einem Ordner als Positionsargument.
Interaktiver Modus
Führe gamedev in einem Projektordner aus. Gib eine Anfrage ein und drücke Enter. Nützliche Tasten:
/öffnet die Slash-Befehlspalette; Pfeiltasten bewegen, Tab vervollständigt den Befehlsnamen.- Esc während einer streamenden Antwort unterbricht sie.
- Strg+C beendet (zweimal drücken zum Bestätigen).
- Halte die Leertaste im Eingabefeld etwa eine Drittelsekunde gedrückt, um zu sprechen (Push-to-Talk-Spracheingabe).
Ohne Terminal (gepipe-te Eingabe) fällt die CLI auf einen einfachen Zeilenmodus zurück.
Headless-Modus und Skripting
Headless-Läufe geben nur die Antwort auf stdout aus; was die CLI erkannt hat (zum Beispiel "Unity project detected") geht nach 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"| Exit-Code | Wann |
|---|---|
0 | Die Antwort wurde abgeschlossen |
1 | Ein Abfrage-, Netzwerk- oder Agent-Fehler oder Strg+C nach dem Start des Laufs |
2 | Nicht angemeldet, ein leerer Prompt oder ein unbrauchbarer Ordner oder Flag |
130 | Strg+C vor dem Start des Laufs; es wurde nichts gesendet |
143 | SIGTERM; die CLI koppelt sich ab und ein bereits gesendeter Prompt läuft im Hintergrunddienst weiter |
gamedev pkg
Verwalte Pakete des Projekts im aktuellen Verzeichnis (oder --cwd <path>). Ebenen-Flags: --user (jedes Projekt auf diesem Computer), --project (eingecheckt, der Standard), --local (nur dieser 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 endet mit Code 1, wenn ein Wert abgelehnt wird, und mit 2 bei einem Nutzungsfehler. Siehe Pakete erstellen für link und 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 serviceDie Modelle selbst werden mit /images innerhalb der CLI verwaltet (siehe unten).
gamedev remote
Remote-Zugriff zwischen deinen Computern und Geräten, die im selben Konto angemeldet sind. /remote in der interaktiven CLI ist derselbe Befehl.
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 seeEin Gerät ist ein Name oder der Anfang seiner ID. pair fragt getrennt nach Anzeigen, Steuern und geteilten Modellen. Danach öffnet gamedev --on <device> die Chats dieses Computers; /machine listet Computer auf oder wechselt zwischen ihnen und /machine this führt zurück.
gamedev daemon
Der Hintergrunddienst, den die Desktop-App und die CLI gemeinsam nutzen.
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]Der OS-Dienst ist ein LaunchAgent unter macOS, eine systemd-User-Unit unter Linux und eine Task-Scheduler-Aufgabe bei der Anmeldung unter Windows; er benötigt keine Admin-Rechte.
gamedev acp
gamedev acp macht die CLI zu einem Agent-Client-Protocol-Agenten für ACP-Clients wie T3 Code, Zed und JetBrains-IDEs. Der Client startet ihn; Protokollnachrichten laufen über stdout und Diagnosen gehen nach stderr. Füge im Client einen benutzerdefinierten Agenten mit dem Befehl gamedev und dem Argument acp hinzu. Er nutzt die Anmeldung dieses Computers, die Modelle deines Kontos und die Engine-Tools des Projekts. Der Beitrag AI Game Dev als ACP-Agent in T3 Code führt durch die Einrichtung.
Slash-Befehle
Gib diese in der interaktiven CLI ein. Viele funktionieren auch im Desktop-Chat.
Chat und Sitzung
| Befehl | Was er tut |
|---|---|
/help | Die verfügbaren Befehle auflisten |
/clear | Eine neue Unterhaltung starten |
/reset | Die aktuelle Sitzung zurücksetzen |
/reopen | Einen verlorenen Chat aus seinem gespeicherten Verlauf wieder öffnen (nichts wird erneut gesendet) |
/saved | Gespeicherte Nachrichten, Einstellungen, Bilder und Datei- oder Git-Änderungen wiederherstellen |
/model | Das Modell auswählen (Tab: Reasoning-Aufwand) |
/agent | Die Agenten auflisten; /agent use <id> wechselt, /agent refresh lädt die Liste neu |
/skills | Die in diesem Projekt verfügbaren Skills auflisten |
/context | Das Kontext-Debug-Panel umschalten |
/exit | Beenden (auch /quit) |
Konto, Einstellungen und Updates
| Befehl | Was er tut |
|---|---|
/login [--switch] | Anmelden; --switch wechselt das Konto dieses Computers |
/logout | Abmelden |
/config | Einstellungen, einschließlich der Tools dieser Sitzung |
/permissions | Anzeigen oder ändern, wann die KI vor dem Ausführen von Tools nachfragt |
/voice-language | Die Sprache für die Sprachtranskription festlegen |
/update [now] | Wie die CLI aktualisiert wird; now aktualisiert einen wartenden Hintergrunddienst |
/remote, /machine | Remote-Zugriff; Computer auflisten oder wechseln |
Engine und Projekt
| Befehl | Was er tut |
|---|---|
/install-plugin [path] | Das MCP-Plugin in das aktuelle Unity-, Godot- oder Unreal-Projekt installieren |
/install-extension | Eine Engine-Erweiterung durchsuchen und installieren |
/open | Den Editor für das aktuelle Projekt öffnen |
/create-project | Ein neues Spielprojekt erstellen, zum Beispiel /create-project unity MyGame (Engine unity, godot oder unreal, ein Name, ein optionaler übergeordneter Ordner) |
/file | Projektdateien erstellen, umbenennen, verschieben, kopieren oder löschen |
/files [n] | In diesem Chat erwähnte Dateien auflisten; eine öffnen |
/search, /replace | Das Projekt durchsuchen; Search Replace speichern, anwenden und wiederherstellen |
/git | Status, Stage, Commit, Discard, Pull, Push, Force-Push und Init |
Erweiterungen, Pakete und Modelle
| Befehl | Was er tut |
|---|---|
/packages | Dieselben Unterbefehle wie gamedev pkg, plus views, tree <view id>, runs, cancel und reload |
/mcp | Die MCP-Server des Projekts verwalten: hinzufügen, aktivieren, entfernen, testen |
/plugin | Claude-Plugins und -Marketplaces verwalten: installieren, aktivieren, aktualisieren |
/images | Lokale Bildmodelle, Downloads und Speicher (/images help) |
/image [n] | Die Bilder dieser Sitzung auflisten; eines öffnen oder entfernen |
/models | Alle Möglichkeiten, ein Medienmodell auszuführen, lokal und in der Cloud; füge image, video, audio oder 3d hinzu (/models help) |
/cloud | Die Cloud-Generierungseinstellung dieser Sitzung: ask, budget <percent> oder off |
/blender, /supercollider, /kb | Befehle der Pakete Blender, Music und Knowledge Base |
Installierte Pakete können weitere Slash-Befehle hinzufügen; sie erscheinen in der /-Palette.
/images-Unterbefehle
/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 againUmgebungsvariablen
| Variable | Zweck |
|---|---|
AI_GAME_DEV_MODEL | Überschreibt das Standardmodell |
AI_GAME_DEV_ASCII_GLYPHS | 1 erzwingt ASCII-Meter im /model-Picker für Terminals, die Emoji falsch vermessen |
Konfigurationspriorität: Kommandozeilenoptionen, dann Umgebungsvariablen, dann ~/.ai-game-dev/config.json.
Verwandte Themen
- Die Engine-Plugins haben ihre eigenen CLIs:
unity-mcp-cli,unreal-mcp-cli,godot-cli. - Fehlerbehebung für Fehler und Exit-Codes in der Praxis.