Diese Seite wurde maschinell aus dem Englischen übersetzt. Englisches Original lesen.

gamedev CLI-Referenz

Alle gamedev CLI-Befehle und -Optionen: interaktiv, Headless, pkg, remote, daemon, acp, image-runtime, update und die Slash-Befehle im Terminal.

Aktualisiert am 4. November 2026 Als Markdown anzeigen

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

Optionen

OptionBedeutung
<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
--headlessNicht-interaktiven Modus erzwingen, Prompt von stdin
--on <name>Die Terminal-UI auf den Chats eines anderen gekoppelten Computers öffnen
--help, -hHilfe anzeigen
--version, -vDie 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-CodeWann
0Die Antwort wurde abgeschlossen
1Ein Abfrage-, Netzwerk- oder Agent-Fehler oder Strg+C nach dem Start des Laufs
2Nicht angemeldet, ein leerer Prompt oder ein unbrauchbarer Ordner oder Flag
130Strg+C vor dem Start des Laufs; es wurde nichts gesendet
143SIGTERM; 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 service

Die 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 see

Ein 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

BefehlWas er tut
/helpDie verfügbaren Befehle auflisten
/clearEine neue Unterhaltung starten
/resetDie aktuelle Sitzung zurücksetzen
/reopenEinen verlorenen Chat aus seinem gespeicherten Verlauf wieder öffnen (nichts wird erneut gesendet)
/savedGespeicherte Nachrichten, Einstellungen, Bilder und Datei- oder Git-Änderungen wiederherstellen
/modelDas Modell auswählen (Tab: Reasoning-Aufwand)
/agentDie Agenten auflisten; /agent use <id> wechselt, /agent refresh lädt die Liste neu
/skillsDie in diesem Projekt verfügbaren Skills auflisten
/contextDas Kontext-Debug-Panel umschalten
/exitBeenden (auch /quit)

Konto, Einstellungen und Updates

BefehlWas er tut
/login [--switch]Anmelden; --switch wechselt das Konto dieses Computers
/logoutAbmelden
/configEinstellungen, einschließlich der Tools dieser Sitzung
/permissionsAnzeigen oder ändern, wann die KI vor dem Ausführen von Tools nachfragt
/voice-languageDie Sprache für die Sprachtranskription festlegen
/update [now]Wie die CLI aktualisiert wird; now aktualisiert einen wartenden Hintergrunddienst
/remote, /machineRemote-Zugriff; Computer auflisten oder wechseln

Engine und Projekt

BefehlWas er tut
/install-plugin [path]Das MCP-Plugin in das aktuelle Unity-, Godot- oder Unreal-Projekt installieren
/install-extensionEine Engine-Erweiterung durchsuchen und installieren
/openDen Editor für das aktuelle Projekt öffnen
/create-projectEin neues Spielprojekt erstellen, zum Beispiel /create-project unity MyGame (Engine unity, godot oder unreal, ein Name, ein optionaler übergeordneter Ordner)
/fileProjektdateien erstellen, umbenennen, verschieben, kopieren oder löschen
/files [n]In diesem Chat erwähnte Dateien auflisten; eine öffnen
/search, /replaceDas Projekt durchsuchen; Search Replace speichern, anwenden und wiederherstellen
/gitStatus, Stage, Commit, Discard, Pull, Push, Force-Push und Init

Erweiterungen, Pakete und Modelle

BefehlWas er tut
/packagesDieselben Unterbefehle wie gamedev pkg, plus views, tree <view id>, runs, cancel und reload
/mcpDie MCP-Server des Projekts verwalten: hinzufügen, aktivieren, entfernen, testen
/pluginClaude-Plugins und -Marketplaces verwalten: installieren, aktivieren, aktualisieren
/imagesLokale Bildmodelle, Downloads und Speicher (/images help)
/image [n]Die Bilder dieser Sitzung auflisten; eines öffnen oder entfernen
/modelsAlle Möglichkeiten, ein Medienmodell auszuführen, lokal und in der Cloud; füge image, video, audio oder 3d hinzu (/models help)
/cloudDie Cloud-Generierungseinstellung dieser Sitzung: ask, budget <percent> oder off
/blender, /supercollider, /kbBefehle 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 again

Umgebungsvariablen

VariableZweck
AI_GAME_DEV_MODELÜberschreibt das Standardmodell
AI_GAME_DEV_ASCII_GLYPHS1 erzwingt ASCII-Meter im /model-Picker für Terminals, die Emoji falsch vermessen

Konfigurationspriorität: Kommandozeilenoptionen, dann Umgebungsvariablen, dann ~/.ai-game-dev/config.json.