# gamedev CLI-Referenz — AI Game Dev App & CLI · AI Game Developer Wiki

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

Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/docs/wiki/app/cli).

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

## Verwendung auf einen Blick

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

## Optionen

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

```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"
```

| 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](https://ai-game.dev/de/docs/wiki/app/packages) des Projekts im aktuellen Verzeichnis (oder `--cwd <path>`). Ebenen-Flags: `--user` (jedes Projekt auf diesem Computer), `--project` (eingecheckt, der Standard), `--local` (nur dieser 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` endet mit Code 1, wenn ein Wert abgelehnt wird, und mit 2 bei einem Nutzungsfehler. Siehe [Pakete erstellen](https://ai-game.dev/de/docs/wiki/app/creating-packages#develop) für `link` und `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
```

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.

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

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.

```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]
```

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

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

## Umgebungsvariablen

| 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`](https://ai-game.dev/de/docs/wiki/unity/cli), [`unreal-mcp-cli`](https://ai-game.dev/de/docs/wiki/unreal/cli), [`godot-cli`](https://ai-game.dev/de/docs/wiki/godot/cli).
- [Fehlerbehebung](https://ai-game.dev/de/docs/wiki/app/troubleshooting) für Fehler und Exit-Codes in der Praxis.

---

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

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