godot-cli 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to `godot-cli` are documented in this file.
+
+## 0.1.0
+
+Initial release. A cross-platform CLI for Godot-MCP, mirroring `unity-mcp-cli`'s feature set and structure,
+adapted for Godot.
+
+- `open` — resolve the Godot editor binary (`GODOT_BIN`/`GODOT4_BIN` → PATH → per-OS common dirs) and
+  launch `--editor --path <project>` with the `GODOT_MCP_*` connection env vars.
+- `run-tool` / `run-system-tool` — POST to `<url>/api/tools/<name>` and `<url>/api/system-tools/<name>`.
+- `status` — detect a running Godot editor and probe MCP-server health.
+- `wait-for-ready` — poll the server until it answers `ping`.
+- `setup-mcp` — write an AI-agent MCP-client config (claude-code, claude-desktop, cursor, vscode, custom)
+  pointing at the Godot server's `<host>/mcp` URL.
+- `configure` — list / enable / disable tools, prompts, and resources in the project-local
+  `.godot-mcp/features.json`.
+- `close` — gracefully terminate the Godot editor for a project (`--force` to hard-kill).
+- `install-plugin` / `remove-plugin` — enable/disable the `godot_mcp` addon in `project.godot`
+  `[editor_plugins]`.
+- `update` — check npm for a newer version and install it.
+
+`setup-skills` is intentionally not ported: Godot skills are generated addon-side by the McpPlugin engine,
+and the Godot MCP server exposes no skill-generate HTTP endpoint.

package/README.md

@@ -0,0 +1,101 @@
+# godot-cli
+
+Cross-platform CLI for **Godot-MCP** — the [Godot](https://godotengine.org/) editor addon that bridges
+LLMs (Claude, Cursor, Copilot, …) with the Godot editor via the
+[Model Context Protocol](https://modelcontextprotocol.io/).
+
+The CLI is the Godot analog of [`unity-mcp-cli`](https://www.npmjs.com/package/unity-mcp-cli): it resolves
+and launches the Godot editor with the right `GODOT_MCP_*` connection environment variables, runs MCP and
+system tools over the server's HTTP API, probes server health, writes AI-agent MCP-client config, and
+enables/disables the `godot_mcp` addon in a project.
+
+> **Licensed under Apache-2.0.**
+
+## Install
+
+```bash
+npm install -g godot-cli
+# or run ad-hoc:
+npx godot-cli <command>
+```
+
+Requires Node `^20.19.0 || >=22.12.0`.
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `open [path]` | Resolve the Godot editor binary and launch `--editor --path <project>` with `GODOT_MCP_*` connection env vars. |
+| `run-tool <tool> [path]` | POST to `<url>/api/tools/<tool>` with JSON input. |
+| `run-system-tool <tool> [path]` | POST to `<url>/api/system-tools/<tool>` (tools not exposed to MCP clients). |
+| `status [path]` | Detect a running Godot editor for the project and probe MCP-server health. |
+| `wait-for-ready [path]` | Poll the MCP server until it answers `ping`. |
+| `setup-mcp <agent> [path]` | Write the agent's MCP-client config pointing at the Godot server's `<host>/mcp` URL. |
+| `configure [path]` | List / enable / disable tools, prompts, and resources in the project-local `.godot-mcp/features.json`. |
+| `close [path]` | Gracefully stop the Godot editor running for a project (`--force` to hard-kill). |
+| `install-plugin [path]` | Enable the `godot_mcp` addon in `project.godot` `[editor_plugins]`. |
+| `remove-plugin [path]` | Disable the `godot_mcp` addon in `project.godot` `[editor_plugins]`. |
+| `update` | Check npm for a newer `godot-cli` and install it. |
+
+### Editor resolution (`open`)
+
+`open` locates the Godot editor binary in this order:
+
+1. `--editor-path <path>` (explicit).
+2. `GODOT_BIN` / `GODOT4_BIN` environment variables.
+3. The first matching Godot binary on `PATH` (the mono build is preferred on Windows).
+4. Per-OS common install directories — Windows prefers the mono build; macOS resolves the
+   `.app/Contents/MacOS/Godot` binary; Linux scans common extracted-binary locations.
+
+### Connection env vars
+
+`open` forwards these to the editor process (names match the addon's `GodotMcpConfig`):
+
+| Flag | Env var |
+| --- | --- |
+| `--url <host>` | `GODOT_MCP_HOST` |
+| `--cloud-url <url>` | `GODOT_MCP_CLOUD_URL` |
+| `--token <token>` | `GODOT_MCP_TOKEN` |
+| `--auth None\|Required` | `GODOT_MCP_AUTH_OPTION` |
+| `--mode Cloud\|Custom` | `GODOT_MCP_CONNECTION_MODE` |
+| `--log-level <level>` | `GODOT_MCP_LOG_LEVEL` |
+
+### Server URL resolution (`run-tool` / `status` / `wait-for-ready`)
+
+Unlike Unity, the Godot plugin is a **server-less client** whose persisted config lives in `user://`
+(outside the project tree), so there is no deterministic project-path → port hash. The server base URL is
+resolved as:
+
+1. `--url <url>` (explicit override).
+2. `GODOT_MCP_HOST` env (Custom-mode host).
+3. `GODOT_MCP_CLOUD_URL` env / Cloud mode → cloud base (`https://ai-game.dev`).
+4. Default custom host (`http://localhost:8080`).
+
+Pass `--url http://localhost:<port>` to target a local/self-hosted server.
+
+## `setup-skills` is not in v1
+
+Unlike the Unity CLI, there is **no `setup-skills` command**. Godot skills are generated **addon-side** by
+the McpPlugin engine on plugin boot (`GodotMcpConnection.Start` → `GenerateSkillFilesIfNeeded`, driven by
+the `GodotMcpConfig.GenerateSkillFiles` toggle, with a manual "Generate" button in the dock's Skills card).
+The Godot MCP server exposes **no** `skill-generate` HTTP endpoint for the CLI to call, so porting
+`setup-skills` would have nothing to invoke. It is intentionally out of scope for v1.
+
+## Library API
+
+The package also exports a side-effect-free library (the `.` entry):
+
+```ts
+import { openProject, runTool, setupMcp, installPlugin } from 'godot-cli';
+```
+
+Every function returns a discriminated union (`{ kind: 'success', ... }` / `{ kind: 'failure', error }`)
+and never throws past the public boundary.
+
+## Development
+
+```bash
+npm install
+npm run build   # tsc → dist/ (ESM)
+npm test        # vitest
+```

package/bin/godot-cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+export { openCommand } from './commands/open.js';
+export { runToolCommand } from './commands/run-tool.js';
+export { runSystemToolCommand } from './commands/run-system-tool.js';
+export { statusCommand } from './commands/status.js';
+export { waitForReadyCommand } from './commands/wait-for-ready.js';
+export { setupMcpCommand } from './commands/setup-mcp.js';
+export { configureCommand } from './commands/configure.js';
+export { closeCommand } from './commands/close.js';
+export { createUpdateCommand } from './commands/update.js';
+export { installPluginCommand } from './commands/install-plugin.js';
+export { removePluginCommand } from './commands/remove-plugin.js';

package/dist/cli.js

@@ -0,0 +1,17 @@
+// CLI entry-point re-exports (`godot-cli/cli`).
+//
+// Exposes the commander Command instances so a consumer can compose them into
+// their own program. The runnable program lives in `index.ts` (imported by
+// `bin/godot-cli.js`).
+export { openCommand } from './commands/open.js';
+export { runToolCommand } from './commands/run-tool.js';
+export { runSystemToolCommand } from './commands/run-system-tool.js';
+export { statusCommand } from './commands/status.js';
+export { waitForReadyCommand } from './commands/wait-for-ready.js';
+export { setupMcpCommand } from './commands/setup-mcp.js';
+export { configureCommand } from './commands/configure.js';
+export { closeCommand } from './commands/close.js';
+export { createUpdateCommand } from './commands/update.js';
+export { installPluginCommand } from './commands/install-plugin.js';
+export { removePluginCommand } from './commands/remove-plugin.js';
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,uBAAuB;AAEvB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/commands/close.d.ts

@@ -0,0 +1,18 @@
+import { Command } from 'commander';
+export interface CloseOptions {
+    timeout?: string;
+    force?: boolean;
+}
+/** Resolve the project path argument to an absolute, canonical path. */
+export declare function resolveCloseProjectPath(positionalPath: string | undefined, cwd: string): string;
+/** True when `<projectPath>/project.godot` exists. */
+export declare function isGodotProjectRoot(projectPath: string): boolean;
+/**
+ * Parse a positive-integer `--timeout` value (seconds). Returns the parsed
+ * value, or `null` when the input is not a valid positive integer. Exported for
+ * unit tests.
+ */
+export declare function parseTimeoutSeconds(raw: string | undefined): number | null;
+/** Resolve the editor PID for a given project path, or null when not running. */
+export declare function resolveEditorPid(projectPath: string): number | null;
+export declare const closeCommand: Command;

package/dist/commands/close.js

@@ -0,0 +1,112 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { platform as nodePlatform } from 'os';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { findGodotProcess } from '../utils/godot-process.js';
+import { isProcessAlive, sendGracefulShutdown, sendForceKill, waitForExit, } from '../utils/godot-shutdown.js';
+const DEFAULT_TIMEOUT_SECONDS = 30;
+/** Resolve the project path argument to an absolute, canonical path. */
+export function resolveCloseProjectPath(positionalPath, cwd) {
+    const explicit = positionalPath ?? cwd;
+    let resolved = path.resolve(explicit);
+    try {
+        resolved = fs.realpathSync(resolved);
+    }
+    catch {
+        // Path may not exist — let the caller decide what to do.
+    }
+    return resolved;
+}
+/** True when `<projectPath>/project.godot` exists. */
+export function isGodotProjectRoot(projectPath) {
+    return fs.existsSync(path.join(projectPath, 'project.godot'));
+}
+/**
+ * Parse a positive-integer `--timeout` value (seconds). Returns the parsed
+ * value, or `null` when the input is not a valid positive integer. Exported for
+ * unit tests.
+ */
+export function parseTimeoutSeconds(raw) {
+    if (raw === undefined)
+        return DEFAULT_TIMEOUT_SECONDS;
+    const parsed = Number(raw);
+    if (!Number.isInteger(parsed) || parsed <= 0)
+        return null;
+    return parsed;
+}
+/** Resolve the editor PID for a given project path, or null when not running. */
+export function resolveEditorPid(projectPath) {
+    const proc = findGodotProcess(projectPath);
+    if (proc) {
+        verbose(`Godot editor PID ${proc.pid} matched for project`);
+        return proc.pid;
+    }
+    return null;
+}
+export const closeCommand = new Command('close')
+    .description('Gracefully terminate the Godot editor instance running for a given project path')
+    .argument('[path]', 'Path to the Godot project (defaults to current directory)')
+    .option('--timeout <seconds>', `Polite-quit timeout in seconds (default: ${DEFAULT_TIMEOUT_SECONDS})`, String(DEFAULT_TIMEOUT_SECONDS))
+    .option('--force', 'Hard-kill the editor if it does not exit within --timeout')
+    .action(async (positionalPath, options) => {
+    const projectPath = resolveCloseProjectPath(positionalPath, process.cwd());
+    verbose(`close invoked for project: ${projectPath}`);
+    if (!fs.existsSync(projectPath)) {
+        ui.error(`Project path does not exist: ${projectPath}`);
+        process.exit(1);
+    }
+    if (!isGodotProjectRoot(projectPath)) {
+        ui.error(`Not a Godot project root: ${projectPath}`);
+        process.exit(1);
+    }
+    const timeoutSeconds = parseTimeoutSeconds(options.timeout);
+    if (timeoutSeconds === null) {
+        ui.error(`Invalid --timeout value: "${options.timeout}". Must be a positive integer (seconds).`);
+        process.exit(1);
+    }
+    const platform = nodePlatform();
+    const pid = resolveEditorPid(projectPath);
+    if (pid === null) {
+        ui.success(`no running editor for project at ${projectPath}`);
+        process.exit(0);
+    }
+    ui.heading('Closing Godot Editor');
+    ui.label('Project', projectPath);
+    ui.label('PID', String(pid));
+    ui.label('Timeout', `${timeoutSeconds}s`);
+    ui.label('Force', options.force ? 'yes' : 'no');
+    ui.divider();
+    const spinner = ui.startSpinner(`Sending polite-quit to PID ${pid}...`);
+    const sent = sendGracefulShutdown(pid, platform);
+    if (!sent) {
+        spinner.error(`Failed to deliver polite-quit signal to PID ${pid}`);
+        process.exit(1);
+    }
+    spinner.text = `Waiting up to ${timeoutSeconds}s for PID ${pid} to exit...`;
+    const exited = await waitForExit(pid, timeoutSeconds * 1000, platform);
+    if (exited) {
+        spinner.success(`Godot editor (PID ${pid}) exited cleanly`);
+        process.exit(0);
+    }
+    if (!options.force) {
+        spinner.error(`Godot editor (PID ${pid}) did not exit within ${timeoutSeconds}s. ` +
+            `Re-run with --force to hard-kill, or close it manually.`);
+        process.exit(1);
+    }
+    spinner.text = `Force-killing PID ${pid}...`;
+    const killed = sendForceKill(pid, platform);
+    if (!killed) {
+        spinner.error(`Failed to force-kill PID ${pid}`);
+        process.exit(1);
+    }
+    const reaped = await waitForExit(pid, 5000, platform);
+    if (reaped || !isProcessAlive(pid, platform)) {
+        spinner.success(`Godot editor (PID ${pid}) force-killed`);
+        process.exit(0);
+    }
+    spinner.error(`Godot editor (PID ${pid}) is still alive after force-kill`);
+    process.exit(1);
+});
+//# sourceMappingURL=close.js.map

package/dist/commands/close.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close.js","sourceRoot":"","sources":["../../src/commands/close.ts"],"names":[],"mappings":"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"}

package/dist/commands/configure.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const configureCommand: Command;

package/dist/commands/configure.js

@@ -0,0 +1,92 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { getOrCreateConfig, writeConfig, updateFeatures, } from '../utils/config.js';
+function parseCommaSeparated(value) {
+    return value.split(',').map((s) => s.trim()).filter(Boolean);
+}
+function buildAction(enable, disable, enableAll, disableAll) {
+    if (!enable && !disable && !enableAll && !disableAll)
+        return undefined;
+    return { enableNames: enable, disableNames: disable, enableAll, disableAll };
+}
+function snapshotFeatures(config, key) {
+    const raw = config[key];
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .filter((f) => typeof f === 'object' && f !== null && typeof f.name === 'string' && typeof f.enabled === 'boolean')
+        .map((f) => ({ name: f.name, enabled: f.enabled }));
+}
+export const configureCommand = new Command('configure')
+    .description('List / enable / disable MCP tools, prompts, and resources in the project-local .godot-mcp/features.json')
+    .argument('[path]', 'Path to the Godot project')
+    .option('--path <path>', 'Path to the Godot project')
+    .option('--enable-tools <names>', 'Enable specific tools (comma-separated)', parseCommaSeparated)
+    .option('--disable-tools <names>', 'Disable specific tools (comma-separated)', parseCommaSeparated)
+    .option('--enable-all-tools', 'Enable all tools')
+    .option('--disable-all-tools', 'Disable all tools')
+    .option('--enable-prompts <names>', 'Enable specific prompts (comma-separated)', parseCommaSeparated)
+    .option('--disable-prompts <names>', 'Disable specific prompts (comma-separated)', parseCommaSeparated)
+    .option('--enable-all-prompts', 'Enable all prompts')
+    .option('--disable-all-prompts', 'Disable all prompts')
+    .option('--enable-resources <names>', 'Enable specific resources (comma-separated)', parseCommaSeparated)
+    .option('--disable-resources <names>', 'Disable specific resources (comma-separated)', parseCommaSeparated)
+    .option('--enable-all-resources', 'Enable all resources')
+    .option('--disable-all-resources', 'Disable all resources')
+    .option('--list', 'List current configuration')
+    .action(async (positionalPath, options) => {
+    const resolvedPath = positionalPath ?? options.path;
+    if (!resolvedPath) {
+        ui.error('Path is required. Usage: godot-cli configure <path> or --path <path>');
+        process.exit(1);
+    }
+    const projectPath = path.resolve(resolvedPath);
+    if (!fs.existsSync(projectPath)) {
+        ui.error(`Project path does not exist: ${projectPath}`);
+        process.exit(1);
+    }
+    verbose(`Loading config for project: ${projectPath}`);
+    const toolsAction = options.list
+        ? undefined
+        : buildAction(options.enableTools, options.disableTools, options.enableAllTools, options.disableAllTools);
+    const promptsAction = options.list
+        ? undefined
+        : buildAction(options.enablePrompts, options.disablePrompts, options.enableAllPrompts, options.disableAllPrompts);
+    const resourcesAction = options.list
+        ? undefined
+        : buildAction(options.enableResources, options.disableResources, options.enableAllResources, options.disableAllResources);
+    const config = getOrCreateConfig(projectPath);
+    const hasAny = (a) => !!a && (!!a.enableNames?.length || !!a.disableNames?.length || a.enableAll === true || a.disableAll === true);
+    if (hasAny(toolsAction))
+        updateFeatures(config, 'tools', toolsAction);
+    if (hasAny(promptsAction))
+        updateFeatures(config, 'prompts', promptsAction);
+    if (hasAny(resourcesAction))
+        updateFeatures(config, 'resources', resourcesAction);
+    if (hasAny(toolsAction) || hasAny(promptsAction) || hasAny(resourcesAction)) {
+        writeConfig(projectPath, config);
+    }
+    if (options.list) {
+        ui.heading('Current configuration');
+        const printFeatures = (featureLabel, features) => {
+            ui.heading(featureLabel);
+            if (features.length === 0) {
+                ui.info('(none configured - all enabled by default)');
+                return;
+            }
+            for (const f of features) {
+                ui.featureRow(f.name, f.enabled);
+            }
+        };
+        printFeatures('Tools', snapshotFeatures(config, 'tools'));
+        printFeatures('Prompts', snapshotFeatures(config, 'prompts'));
+        printFeatures('Resources', snapshotFeatures(config, 'resources'));
+        return;
+    }
+    verbose('Writing updated configuration');
+    ui.success('Configuration updated successfully.');
+});
+//# sourceMappingURL=configure.js.map

package/dist/commands/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../../src/commands/configure.ts"],"names":[],"mappings":"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"}

package/dist/commands/install-plugin.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const installPluginCommand: Command;

package/dist/commands/install-plugin.js

@@ -0,0 +1,35 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { installPlugin } from '../lib/install-plugin.js';
+export const installPluginCommand = new Command('install-plugin')
+    .description('Enable the godot_mcp addon in a project (adds res://addons/godot_mcp/plugin.cfg to project.godot [editor_plugins])')
+    .argument('[path]', 'Path to the Godot project')
+    .option('--path <path>', 'Path to the Godot project')
+    .action(async (positionalPath, options) => {
+    const resolvedPath = positionalPath ?? options.path ?? process.cwd();
+    const projectPath = path.resolve(resolvedPath);
+    ui.heading('Enabling godot_mcp addon');
+    verbose(`Project path: ${projectPath}`);
+    const spinner = ui.startSpinner('Updating project.godot...');
+    const result = await installPlugin({ godotProjectPath: projectPath });
+    if (result.kind === 'failure') {
+        spinner.error('Failed to enable plugin');
+        ui.error(result.error.message);
+        process.exit(1);
+    }
+    if (result.changed) {
+        spinner.success('godot_mcp addon enabled');
+    }
+    else {
+        spinner.success('godot_mcp addon was already enabled');
+    }
+    ui.label('project.godot', result.projectGodotPath);
+    ui.label('Enabled plugins', result.enabledPlugins.join(', ') || '(none)');
+    for (const warning of result.warnings) {
+        console.log('');
+        ui.warn(warning);
+    }
+});
+//# sourceMappingURL=install-plugin.js.map

package/dist/commands/install-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-plugin.js","sourceRoot":"","sources":["../../src/commands/install-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAMzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;KAC9D,WAAW,CAAC,oHAAoH,CAAC;KACjI,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;KAC/C,MAAM,CAAC,eAAe,EAAE,2BAA2B,CAAC;KACpD,MAAM,CAAC,KAAK,EAAE,cAAkC,EAAE,OAAgC,EAAE,EAAE;IACrF,MAAM,YAAY,GAAG,cAAc,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACrE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/C,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvC,OAAO,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC;IAEtE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACzC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACnD,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC;IAE1E,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/commands/open.d.ts

@@ -0,0 +1,16 @@
+import { Command } from 'commander';
+import { isGodotProjectDir as libIsGodotProjectDir } from '../lib/open.js';
+export interface ResolveProjectPathResult {
+    /** Absolute, resolved path to the project directory. */
+    projectPath: string;
+    /** True if no path was supplied and we fell back to `process.cwd()`. */
+    usedCwdFallback: boolean;
+}
+/**
+ * Resolve the project path from the positional argument, `--path` option, or
+ * the current working directory when neither is provided. Re-exported for tests.
+ */
+export declare function resolveOpenProjectPath(positionalPath: string | undefined, optionPath: string | undefined, cwd: string): ResolveProjectPathResult;
+/** Re-export for backward compatibility with tests. */
+export declare const isGodotProjectDir: typeof libIsGodotProjectDir;
+export declare const openCommand: Command;

package/dist/commands/open.js

@@ -0,0 +1,124 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as ui from '../utils/ui.js';
+import { verbose } from '../utils/ui.js';
+import { openProject, resolveProjectPath as libResolveProjectPath, isGodotProjectDir as libIsGodotProjectDir, } from '../lib/open.js';
+/**
+ * Resolve the project path from the positional argument, `--path` option, or
+ * the current working directory when neither is provided. Re-exported for tests.
+ */
+export function resolveOpenProjectPath(positionalPath, optionPath, cwd) {
+    const explicit = positionalPath ?? optionPath;
+    return libResolveProjectPath(explicit, cwd);
+}
+/** Re-export for backward compatibility with tests. */
+export const isGodotProjectDir = libIsGodotProjectDir;
+export const openCommand = new Command('open')
+    .description('Open a Godot project in the Godot editor, optionally passing GODOT_MCP_* connection env vars when connection options (--url, --token, etc.) are provided. Use --no-connect to suppress all MCP env vars.')
+    .argument('[path]', 'Path to the Godot project (defaults to current directory)')
+    .option('--path <path>', 'Path to the Godot project (defaults to current directory)')
+    .option('--editor-path <path>', 'Explicit path to the Godot editor executable (skips discovery)')
+    .option('--no-connect', 'Open without MCP connection environment variables')
+    .option('--url <url>', 'MCP server host to connect to (sets GODOT_MCP_HOST)')
+    .option('--cloud-url <url>', 'Cloud base URL override (sets GODOT_MCP_CLOUD_URL)')
+    .option('--token <token>', 'Auth token (sets GODOT_MCP_TOKEN)')
+    .option('--auth <option>', 'Auth option: None or Required (sets GODOT_MCP_AUTH_OPTION)')
+    .option('--mode <mode>', 'Connection mode: Cloud or Custom (sets GODOT_MCP_CONNECTION_MODE)')
+    .option('--log-level <level>', 'Log level: Trace/Debug/Info/Warning/Error/None (sets GODOT_MCP_LOG_LEVEL)')
+    .action(async (positionalPath, options) => {
+    const { projectPath, usedCwdFallback } = resolveOpenProjectPath(positionalPath, options.path, process.cwd());
+    const fs = await import('fs');
+    if (!fs.existsSync(projectPath)) {
+        ui.error(`Project path does not exist: ${projectPath}`);
+        process.exit(1);
+    }
+    if (!libIsGodotProjectDir(projectPath)) {
+        if (usedCwdFallback) {
+            ui.error(`Current directory is not a Godot project: ${projectPath}`);
+            ui.info('Run this command from a Godot project folder, or pass a path: godot-cli open <path>');
+        }
+        else {
+            ui.error(`Not a Godot project (missing project.godot): ${projectPath}`);
+        }
+        process.exit(1);
+    }
+    if (usedCwdFallback) {
+        verbose(`No path provided — using current directory: ${projectPath}`);
+    }
+    verbose(`open invoked for project: ${projectPath}`);
+    verbose(`--no-connect: ${options.connect === false}`);
+    // Validate auth/mode here so the CLI emits a clear error + exit code.
+    if (options.auth !== undefined && options.auth !== 'None' && options.auth !== 'Required') {
+        ui.error('--auth must be "None" or "Required"');
+        process.exit(1);
+    }
+    if (options.mode !== undefined && options.mode !== 'Cloud' && options.mode !== 'Custom') {
+        ui.error('--mode must be "Cloud" or "Custom"');
+        process.exit(1);
+    }
+    const spinner = ui.startSpinner('Locating Godot editor...');
+    const result = await openProject({
+        projectPath,
+        editorPath: options.editorPath,
+        noConnect: options.connect === false,
+        url: options.url,
+        cloudUrl: options.cloudUrl,
+        token: options.token,
+        auth: options.auth,
+        mode: options.mode,
+        logLevel: options.logLevel,
+        onProgress: (event) => {
+            switch (event.phase) {
+                case 'editor-resolved': {
+                    spinner.success('Godot editor located');
+                    verbose(`Editor path: ${event.editorPath}`);
+                    break;
+                }
+                case 'connection-details': {
+                    const envVars = event.envVars;
+                    if (Object.keys(envVars).length > 0) {
+                        ui.heading('Connection Details');
+                        ui.label('Project', event.projectPath);
+                        ui.label('Editor', event.editorPath);
+                        ui.heading('Environment Variables');
+                        for (const [key, value] of Object.entries(envVars)) {
+                            const display = key === 'GODOT_MCP_TOKEN' ? '***' : value;
+                            ui.label(key, display);
+                        }
+                        ui.divider();
+                    }
+                    else {
+                        verbose('MCP connection disabled via --no-connect or no options');
+                    }
+                    break;
+                }
+                case 'launching-editor': {
+                    ui.label('Project', event.projectPath);
+                    ui.label('Editor', event.editorPath);
+                    break;
+                }
+                case 'editor-launched': {
+                    ui.success(`Launched Godot editor (PID: ${event.pid ?? 'unknown'})`);
+                    break;
+                }
+                default:
+                    break;
+            }
+        },
+    });
+    if (result.kind === 'failure') {
+        // The spinner.success() on editor-resolved only fires on the happy
+        // path; on failure stop it so the error renders cleanly.
+        spinner.stop();
+        ui.error(result.errorMessage);
+        process.exit(1);
+    }
+    if (result.alreadyRunning) {
+        spinner.stop();
+        ui.success(`Godot is already running with this project (PID: ${result.editorPid ?? 'unknown'})`);
+        ui.info('Skipping launch. Use the running instance or close it first.');
+        process.exit(0);
+    }
+    verbose(`Resolved project path: ${path.resolve(result.projectPath)}`);
+});
+//# sourceMappingURL=open.js.map

package/dist/commands/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/commands/open.ts"],"names":[],"mappings":"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"}

package/dist/commands/remove-plugin.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const removePluginCommand: Command;