@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 +37 -83
- package/bin/postinstall.js +41 -13
- package/package.json +8 -8
package/README.md
CHANGED
|
@@ -1,103 +1,57 @@
|
|
|
1
|
-
<div align="center"
|
|
2
|
-
<h1>AI Game Dev — <i>CLI</i></h1>
|
|
3
|
-
|
|
4
|
-
[](https://www.npmjs.com/package/@baizor/gamedev)
|
|
5
|
-
[](https://www.npmjs.com/package/@baizor/gamedev)
|
|
6
|
-
[](https://nodejs.org/)
|
|
7
|
-
[](https://ai-game.dev)
|
|
8
|
-
[](https://ai-game.dev)
|
|
9
|
-
[](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>
|
|
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>
|
|
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>
|
|
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>
|
|
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>
|
|
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>
|
|
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>
|
|
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
|
-
</
|
|
3
|
+
<h1>AI Game Dev — CLI</h1>
|
|
25
4
|
|
|
26
|
-
|
|
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
|
+
[](https://www.npmjs.com/package/@baizor/gamedev) [](https://www.npmjs.com/package/@baizor/gamedev) [](https://nodejs.org/) [](https://ai-game.dev) [](https://stand-with-ukraine.pp.ua)
|
|
31
6
|
|
|
32
|
-
|
|
7
|
+
</div>
|
|
33
8
|
|
|
34
|
-
-
|
|
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
|
-
|
|
11
|
+
## Features
|
|
43
12
|
|
|
44
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
34
|
+
## Usage
|
|
67
35
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
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
|
-

|
|
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
|
-
|
|
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
|
-
|
|
47
|
+
## Engines
|
|
92
48
|
|
|
93
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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)
|
package/bin/postinstall.js
CHANGED
|
@@ -34,24 +34,52 @@ try {
|
|
|
34
34
|
);
|
|
35
35
|
}
|
|
36
36
|
|
|
37
|
-
//
|
|
38
|
-
|
|
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
|
|
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
|
|
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.
|
|
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.
|
|
35
|
-
"@napi-rs/keyring": "1.
|
|
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.
|
|
40
|
-
"game-dev-cli-darwin-x64": "0.30.
|
|
41
|
-
"game-dev-cli-linux-arm64": "0.30.
|
|
42
|
-
"game-dev-cli-linux-x64": "0.30.
|
|
43
|
-
"game-dev-cli-windows-x64": "0.30.
|
|
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"
|