@baizor/gamedev 0.30.0 → 0.30.1-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,103 +1,57 @@
1
- <div align="center" width="100%">
2
- <h1>AI Game Dev — <i>CLI</i></h1>
3
-
4
- [![npm](https://img.shields.io/npm/v/@baizor/gamedev?label=npm&labelColor=333A41 'npm package')](https://www.npmjs.com/package/@baizor/gamedev)
5
- [![Downloads](https://img.shields.io/npm/dm/@baizor/gamedev?label=downloads&labelColor=333A41)](https://www.npmjs.com/package/@baizor/gamedev)
6
- [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22-5FA04E?logo=nodedotjs&labelColor=333A41 'Node.js')](https://nodejs.org/)
7
- [![License](https://img.shields.io/npm/l/@baizor/gamedev?label=License&labelColor=333A41)](https://ai-game.dev)
8
- [![Website](https://img.shields.io/badge/website-ai--game.dev-bc6c25?labelColor=333A41)](https://ai-game.dev)
9
- [![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://stand-with-ukraine.pp.ua)
10
-
11
- <img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/promo/ai-developer-banner-glitch.gif" alt="AI Game Developer" title="AI Game Dev CLI" width="100%">
12
-
13
- <p>
14
- <a href="https://claude.ai/download"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/claude-64.png" alt="Claude" title="Claude" height="36"></a>&nbsp;&nbsp;
15
- <a href="https://openai.com/index/introducing-codex/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/codex-64.png" alt="Codex" title="Codex" height="36"></a>&nbsp;&nbsp;
16
- <a href="https://www.cursor.com/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/cursor-64.png" alt="Cursor" title="Cursor" height="36"></a>&nbsp;&nbsp;
17
- <a href="https://code.visualstudio.com/docs/copilot/overview"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/github-copilot-64.png" alt="GitHub Copilot" title="GitHub Copilot" height="36"></a>&nbsp;&nbsp;
18
- <a href="https://gemini.google.com/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/gemini-64.png" alt="Gemini" title="Gemini" height="36"></a>&nbsp;&nbsp;
19
- <a href="https://antigravity.google/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/antigravity-64.png" alt="Antigravity" title="Antigravity" height="36"></a>&nbsp;&nbsp;
20
- <a href="https://code.visualstudio.com/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/vs-code-64.png" alt="VS Code" title="VS Code" height="36"></a>&nbsp;&nbsp;
21
- <a href="https://www.jetbrains.com/rider/"><img src="https://github.com/IvanMurzak/Unity-MCP/raw/main/docs/img/mcp-clients/rider-64.png" alt="Rider" title="Rider" height="36"></a>
22
- </p>
1
+ <div align="center">
23
2
 
24
- </div>
3
+ <h1>AI Game Dev — CLI</h1>
25
4
 
26
- **The AI game developer in your terminal.** `gamedev` is the command-line agent from
27
- **[ai-game.dev](https://ai-game.dev)** — an AI teammate that understands your game project and drives
28
- your engine (**Unity**, **Godot**, **Unreal**) through natural language, right from the command line. It
29
- is the terminal companion to the [AI Game Developer](https://ai-game.dev) desktop app and is powered by
30
- the same **Claude Agent SDK** that runs Claude Code.
5
+ [![npm](https://img.shields.io/npm/v/@baizor/gamedev?label=CLI&color=BE185D&logo=npm&style=for-the-badge&labelColor=0F172A&logoColor=white)](https://www.npmjs.com/package/@baizor/gamedev) [![Downloads](https://img.shields.io/npm/dm/@baizor/gamedev?label=downloads&color=2F6F9F&style=for-the-badge&labelColor=0F172A&logoColor=white)](https://www.npmjs.com/package/@baizor/gamedev) [![Node.js >= 22](https://img.shields.io/badge/Node.js-%3E%3D22-0E7490?logo=nodedotjs&style=for-the-badge&labelColor=0F172A&logoColor=white)](https://nodejs.org/) [![Website](https://img.shields.io/badge/site-ai--game.dev-2F6F9F?style=for-the-badge&labelColor=0F172A&logoColor=white)](https://ai-game.dev) [![Stand with Ukraine](https://raw.githubusercontent.com/IvanMurzak/IvanMurzak/main/images/ukraine/flag-badge.svg)](https://stand-with-ukraine.pp.ua)
31
6
 
32
- ## ![AI Game Developer — Skills and MCP](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-features.svg?raw=true)
7
+ </div>
33
8
 
34
- - :video_game: **Engine-aware** — understands Unity, Godot, and Unreal projects out of the box
35
- - :robot: **Real agentic coding** — reads, writes, and edits your project; runs tools; iterates until it works
36
- - :electric_plug: **One-command engine wiring** — installs and configures the MCP plugin for your engine
37
- - :brain: **Powered by the Claude Agent SDK** — the same agent engine behind Claude Code
38
- - :desktop_computer: **CLI + Desktop** — pairs with the [ai-game.dev](https://ai-game.dev) desktop app; share one account
39
- - :globe_with_meridians: **Cross-platform** — Windows, macOS, and Linux, as a single self-contained binary
40
- - :moneybag: **Free to start** — sign in with your account and upgrade to Pro at [ai-game.dev](https://ai-game.dev)
9
+ **The AI game developer in your terminal.** `gamedev` is the command-line agent from [ai-game.dev](https://ai-game.dev): it understands your game project and drives your engine (**Unity**, **Godot**, **Unreal**) from a chat in the terminal. It is the terminal companion of the [AI Game Dev desktop app](https://ai-game.dev/download), built on the Claude Agent SDK.
41
10
 
42
- ![divider](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
11
+ ## Features
43
12
 
44
- # Quick Start
13
+ <p>
14
+ ✅ <b>Engine-aware</b> — detects Unity, Godot and Unreal projects, installs the plugin, opens editors<br>
15
+ ✅ <b>Real agentic coding</b> — reads and edits your project, runs tools, checks its own work<br>
16
+ ✅ <b>Shared with the desktop app</b> — same account, chats and settings on the same computer<br>
17
+ ✅ <b>Headless mode</b> — <code>gamedev --print</code> for scripts and CI<br>
18
+ ✅ <b>ACP agent</b> — <code>gamedev acp</code> for Agent Client Protocol clients such as Zed<br>
19
+ ✅ <b>Cross-platform</b> — Windows, macOS and Linux, as a prebuilt binary
20
+ </p>
21
+
22
+ ## Quick start
45
23
 
46
24
  ```bash
47
- # 1. Install globally
48
25
  npm install -g @baizor/gamedev
49
-
50
- # 2. Go to your game project and launch the agent
51
- cd /path/to/your/game
26
+ cd path/to/your/game
52
27
  gamedev
53
28
  ```
54
29
 
55
- Or run it instantly with `npx` — no global install required:
56
-
57
- ```bash
58
- npx @baizor/gamedev
59
- ```
60
-
61
- > **Requirements:** [Node.js](https://nodejs.org/) >= 22. On first launch, sign in with your free
62
- > [ai-game.dev](https://ai-game.dev) account.
30
+ Or run it without installing: `npx @baizor/gamedev`.
63
31
 
64
- ![divider](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
32
+ > **Requirements:** [Node.js](https://nodejs.org/) >= 22. On first launch, sign in with your [ai-game.dev](https://ai-game.dev) account.
65
33
 
66
- # What It Does
34
+ ## Usage
67
35
 
68
- `gamedev` puts an autonomous, project-aware AI developer at your prompt:
69
-
70
- - **Understands your engine.** It detects whether you are in a Unity, Godot, or Unreal project and adapts
71
- — using the right tools and the right conventions for your engine.
72
- - **Edits real code.** It reads and writes files across your project, runs commands, and verifies its own
73
- work, just like [Claude Code](https://www.anthropic.com/claude-code) — but tuned for game development.
74
- - **Drives your engine over MCP.** Through the AI Game Developer plugins it can create scenes, spawn
75
- objects, author scripts, capture screenshots, and run tests inside the live editor.
76
- - **Works with the desktop app.** Prefer a GUI? The same account and the same agent power the
77
- [AI Game Developer](https://ai-game.dev) desktop application.
78
-
79
- ![divider](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
80
-
81
- # Supported Engines
82
-
83
- `gamedev` works across all three major engines via the AI Game Developer plugins and their companion CLIs:
36
+ ```bash
37
+ gamedev [<project-dir>] # chat in a project (default: current folder)
38
+ gamedev --print "<prompt>" # one-shot, streams the answer to stdout
39
+ gamedev --resume <id> # continue a previous chat
40
+ gamedev update # update the engine plugin, extensions and the CLI
41
+ gamedev remote | daemon | pkg # remote access, background service, packages
42
+ gamedev --help # everything else
43
+ ```
84
44
 
85
- | Engine | Plugin CLI |
86
- | --- | --- |
87
- | **Unity** | [`unity-mcp-cli`](https://www.npmjs.com/package/unity-mcp-cli) |
88
- | **Godot** | [`godot-cli`](https://www.npmjs.com/package/godot-cli) |
89
- | **Unreal** | [`unreal-mcp-cli`](https://www.npmjs.com/package/unreal-mcp-cli) |
45
+ Inside a chat, type `/help` for the list of slash commands.
90
46
 
91
- ![divider](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/img/promo/hazzard-divider.svg?raw=true)
47
+ ## Engines
92
48
 
93
- # Links
49
+ | Engine | Plugin | Plugin CLI |
50
+ |---|---|---|
51
+ | Unity | [Unity-MCP](https://github.com/IvanMurzak/Unity-MCP) | [`unity-mcp-cli`](https://www.npmjs.com/package/unity-mcp-cli) |
52
+ | Godot | [Godot-MCP](https://github.com/IvanMurzak/Godot-MCP) | [`godot-cli`](https://www.npmjs.com/package/godot-cli) |
53
+ | Unreal | [Unreal-MCP](https://github.com/IvanMurzak/Unreal-MCP) | [`unreal-mcp-cli`](https://www.npmjs.com/package/unreal-mcp-cli) |
94
54
 
95
- - :globe_with_meridians: **Website:** [ai-game.dev](https://ai-game.dev)
96
- - :desktop_computer: **Desktop app:** [ai-game.dev](https://ai-game.dev)
97
- - :package: **Engine plugins:** [unity-mcp-cli](https://www.npmjs.com/package/unity-mcp-cli) ·
98
- [godot-cli](https://www.npmjs.com/package/godot-cli) ·
99
- [unreal-mcp-cli](https://www.npmjs.com/package/unreal-mcp-cli)
55
+ ## Links
100
56
 
101
- <div align="center">
102
- <sub>Made with :orange_heart: for game developers — <a href="https://ai-game.dev">ai-game.dev</a></sub>
103
- </div>
57
+ [ai-game.dev](https://ai-game.dev) · [desktop app](https://ai-game.dev/download) · [documentation](https://ai-game.dev/docs) · [terms](https://ai-game.dev/legal/terms)
@@ -34,24 +34,52 @@ try {
34
34
  );
35
35
  }
36
36
 
37
- // A global install or upgrade (`npm install -g @baizor/gamedev`): the newly
38
- // installed binary asks an older running background service to update once it is
39
- // idle (`gamedev host-update` stages its runtime first, never starts a service and
40
- // never interrupts work). Detached and silent: it must never block or fail the
41
- // installation. A project-local install drives nothing, and neither does
42
- // `gamedev update`'s own npm run, which runs host-update itself and waits for it.
43
- // Both names repeat `packages/cli/src/daemon/host-update-command.ts`.
44
- const HOST_UPDATE_COMMAND = "host-update";
45
- const SKIP_HOST_UPDATE_ENV = "AIGD_SKIP_POSTINSTALL_HOST_UPDATE";
46
- if (packageName && process.env.npm_config_global === "true" && process.env[SKIP_HOST_UPDATE_ENV] !== "1") {
37
+ // The installed binary, or undefined when its platform package is missing.
38
+ function installedBinary() {
47
39
  try {
48
40
  const path = require("path");
41
+ return path.join(path.dirname(require.resolve(`${packageName}/package.json`)), "bin", process.platform === "win32" ? "ai-game-dev.exe" : "ai-game-dev");
42
+ } catch {
43
+ return undefined;
44
+ }
45
+ }
46
+
47
+ // Detached and silent: never blocks or fails the installation, whatever the child does.
48
+ function startDetached(args) {
49
+ const binary = installedBinary();
50
+ if (!binary) return;
51
+ try {
49
52
  const { spawn } = require("child_process");
50
- const binary = path.join(path.dirname(require.resolve(`${packageName}/package.json`)), "bin", process.platform === "win32" ? "ai-game-dev.exe" : "ai-game-dev");
51
- const child = spawn(binary, [HOST_UPDATE_COMMAND], { detached: true, stdio: "ignore", windowsHide: true });
53
+ const child = spawn(binary, args, { detached: true, stdio: "ignore", windowsHide: true });
52
54
  child.on("error", () => {});
53
55
  child.unref();
54
56
  } catch {
55
- // Nothing to ask: the next start of a newer AI Game Dev asks instead.
57
+ // Nothing started: the App does the same work itself later.
56
58
  }
57
59
  }
60
+
61
+ // A global install or upgrade (`npm install -g @baizor/gamedev`): the newly
62
+ // installed binary asks an older running background service to update once it is
63
+ // idle (`gamedev host-update` stages its runtime first, never starts a service and
64
+ // never interrupts work). A project-local install drives nothing, and neither does
65
+ // `gamedev update`'s own npm run, which runs host-update itself and waits for it.
66
+ // Both names repeat `packages/cli/src/daemon/host-update-command.ts`.
67
+ const HOST_UPDATE_COMMAND = "host-update";
68
+ const SKIP_HOST_UPDATE_ENV = "AIGD_SKIP_POSTINSTALL_HOST_UPDATE";
69
+ if (packageName && process.env.npm_config_global === "true" && process.env[SKIP_HOST_UPDATE_ENV] !== "1") startDetached([HOST_UPDATE_COMMAND]);
70
+
71
+ // Every install: prepare, in the background, the runtimes of the engines that fetch
72
+ // theirs ahead of time (`gamedev prefetch-engines`, e.g. Node.js for Three.js games),
73
+ // so the first project of that engine opens fast. Skipped in CI, when
74
+ // AIGD_SKIP_PREFETCH=1, and as root (a `sudo npm install -g` would fill root's home,
75
+ // or leave root-owned files in the user's): the App's background service prefetches
76
+ // 30 s after it starts anyway, and a success is not repeated. `gamedev update` starts
77
+ // it itself after its npm run (npm 12 may skip this script) and sets AIGD_SKIP_PREFETCH=1
78
+ // on that run (`packages/cli/src/utils/run-update.ts`, `startInstalledPrefetch`).
79
+ // The names repeat `packages/cli/src/daemon/prefetch-engines.ts` (the command) and core
80
+ // `engine-packages/install-prefetch.ts` (the skip variable and the CI rule).
81
+ const PREFETCH_COMMAND = "prefetch-engines";
82
+ const SKIP_PREFETCH_ENV = "AIGD_SKIP_PREFETCH";
83
+ const inCi = Boolean(process.env.CI) && process.env.CI !== "0" && process.env.CI.toLowerCase() !== "false";
84
+ const isRoot = typeof process.getuid === "function" && process.getuid() === 0;
85
+ if (packageName && !inCi && process.env[SKIP_PREFETCH_ENV] !== "1" && !isRoot) startDetached([PREFETCH_COMMAND]);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@baizor/gamedev",
3
- "version": "0.30.0",
3
+ "version": "0.30.1-beta.2",
4
4
  "description": "AI Game Dev CLI — the AI game developer in your terminal. An engine-aware AI coding agent for Unity, Godot, and Unreal, powered by the Claude Agent SDK.",
5
5
  "license": "SEE LICENSE IN https://ai-game.dev/legal/terms",
6
6
  "homepage": "https://ai-game.dev",
@@ -31,16 +31,16 @@
31
31
  "README.md"
32
32
  ],
33
33
  "dependencies": {
34
- "@anthropic-ai/claude-agent-sdk": "0.3.322",
35
- "@napi-rs/keyring": "1.3.0",
34
+ "@anthropic-ai/claude-agent-sdk": "0.3.323",
35
+ "@napi-rs/keyring": "2.1.2",
36
36
  "@huggingface/transformers": "4.3.2"
37
37
  },
38
38
  "optionalDependencies": {
39
- "game-dev-cli-darwin-arm64": "0.30.0",
40
- "game-dev-cli-darwin-x64": "0.30.0",
41
- "game-dev-cli-linux-arm64": "0.30.0",
42
- "game-dev-cli-linux-x64": "0.30.0",
43
- "game-dev-cli-windows-x64": "0.30.0"
39
+ "game-dev-cli-darwin-arm64": "0.30.1-beta.2",
40
+ "game-dev-cli-darwin-x64": "0.30.1-beta.2",
41
+ "game-dev-cli-linux-arm64": "0.30.1-beta.2",
42
+ "game-dev-cli-linux-x64": "0.30.1-beta.2",
43
+ "game-dev-cli-windows-x64": "0.30.1-beta.2"
44
44
  },
45
45
  "scripts": {
46
46
  "postinstall": "node bin/postinstall.js"