@bridgent/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Mark and Bridgent contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,10 @@
+# bridgent
+
+> Bridgent CLI — `bridgent dev <file>` to launch an MCP server from any TS/JS file.
+
+```bash
+pnpm add -D bridgent @bridgent/core zod
+bridgent dev ./server.ts
+```
+
+Requires Node `>= 22.18` (uses native `--experimental-strip-types` for TypeScript).

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+import { defineCommand, runMain } from "citty";
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import process from "node:process";
+import { consola } from "consola";
+//#region src/commands/dev.ts
+const dev = defineCommand({
+	meta: {
+		name: "dev",
+		description: "Start an MCP server from a TypeScript or JavaScript file"
+	},
+	args: { file: {
+		type: "positional",
+		description: "Path to the server file (TS or JS)",
+		required: true
+	} },
+	async run({ args }) {
+		const file = resolve(process.cwd(), args.file);
+		if (!existsSync(file)) {
+			consola.error(`File not found: ${file}`);
+			process.exit(1);
+		}
+		const nodeArgs = file.endsWith(".ts") || file.endsWith(".tsx") || file.endsWith(".mts") ? [
+			"--experimental-strip-types",
+			"--no-warnings=ExperimentalWarning",
+			file
+		] : [file];
+		consola.info(`Starting MCP server: ${file}`);
+		const child = spawn(process.execPath, nodeArgs, {
+			stdio: "inherit",
+			env: process.env
+		});
+		child.on("exit", (code) => {
+			process.exit(code ?? 0);
+		});
+		const forward = (signal) => {
+			if (!child.killed) child.kill(signal);
+		};
+		process.on("SIGINT", () => forward("SIGINT"));
+		process.on("SIGTERM", () => forward("SIGTERM"));
+	}
+});
+//#endregion
+//#region src/commands/inspect.ts
+/**
+* `bridgent inspect <file>` is a thin wrapper around the official MCP Inspector.
+*
+* It spawns Inspector via `pnpm dlx` (falling back to `npx -y` if unavailable)
+* and connects it to the user's server file using stdio. The Inspector opens
+* a browser window letting you list tools, send `tools/call`, and see traces.
+*
+* This is intentionally a thin wrapper — Bridgent's own inspector UI ships
+* later as a differentiated experience.
+*/
+const inspect = defineCommand({
+	meta: {
+		name: "inspect",
+		description: "Open MCP Inspector and connect it to your server (stdio)."
+	},
+	args: { file: {
+		type: "positional",
+		description: "Path to the server file (TS or JS).",
+		required: true
+	} },
+	async run({ args }) {
+		const file = resolve(process.cwd(), args.file);
+		if (!existsSync(file)) {
+			consola.error(`File not found: ${file}`);
+			process.exit(1);
+		}
+		const targetArgs = file.endsWith(".ts") || file.endsWith(".tsx") || file.endsWith(".mts") ? [
+			process.execPath,
+			"--experimental-strip-types",
+			"--no-warnings=ExperimentalWarning",
+			file
+		] : [process.execPath, file];
+		consola.info("Starting MCP Inspector …");
+		const launcher = pickLauncher();
+		if (!launcher) {
+			consola.error("Neither `pnpm` nor `npx` is on PATH. Install one of them and try again.");
+			process.exit(1);
+		}
+		const child = spawn(launcher.cmd, [
+			...launcher.args,
+			"@modelcontextprotocol/inspector",
+			...targetArgs
+		], {
+			stdio: "inherit",
+			env: process.env
+		});
+		child.on("exit", (code) => {
+			process.exit(code ?? 0);
+		});
+		const forward = (signal) => {
+			if (!child.killed) child.kill(signal);
+		};
+		process.on("SIGINT", () => forward("SIGINT"));
+		process.on("SIGTERM", () => forward("SIGTERM"));
+	}
+});
+function pickLauncher() {
+	if (process.env.npm_execpath?.includes("pnpm") || process.env.PNPM_HOME) return {
+		cmd: "pnpm",
+		args: ["dlx"]
+	};
+	return {
+		cmd: "npx",
+		args: ["-y"]
+	};
+}
+//#endregion
+//#region src/cli.ts
+runMain(defineCommand({
+	meta: {
+		name: "bridgent",
+		version: "0.0.1",
+		description: "Expose your existing APIs, databases, and code as MCP servers"
+	},
+	subCommands: {
+		dev,
+		serve: defineCommand({
+			meta: {
+				name: "serve",
+				description: "Run a Bridgent server file (typically using createHttpServer)."
+			},
+			args: { file: {
+				type: "positional",
+				description: "Path to the server file (TS or JS).",
+				required: true
+			} },
+			async run({ args }) {
+				const file = resolve(process.cwd(), args.file);
+				if (!existsSync(file)) {
+					consola.error(`File not found: ${file}`);
+					process.exit(1);
+				}
+				const nodeArgs = file.endsWith(".ts") || file.endsWith(".tsx") || file.endsWith(".mts") ? [
+					"--experimental-strip-types",
+					"--no-warnings=ExperimentalWarning",
+					file
+				] : [file];
+				consola.info(`Starting server: ${file}`);
+				const child = spawn(process.execPath, nodeArgs, {
+					stdio: "inherit",
+					env: process.env
+				});
+				child.on("exit", (code) => {
+					process.exit(code ?? 0);
+				});
+				const forward = (signal) => {
+					if (!child.killed) child.kill(signal);
+				};
+				process.on("SIGINT", () => forward("SIGINT"));
+				process.on("SIGTERM", () => forward("SIGTERM"));
+			}
+		}),
+		inspect
+	}
+}));
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/commands/dev.ts","../src/commands/inspect.ts","../src/commands/serve.ts","../src/cli.ts"],"sourcesContent":["import { spawn } from 'node:child_process'\nimport { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport process from 'node:process'\nimport { defineCommand } from 'citty'\nimport { consola } from 'consola'\n\nexport const dev = defineCommand({\n  meta: {\n    name: 'dev',\n    description: 'Start an MCP server from a TypeScript or JavaScript file',\n  },\n  args: {\n    file: {\n      type: 'positional',\n      description: 'Path to the server file (TS or JS)',\n      required: true,\n    },\n  },\n  async run({ args }): Promise<void> {\n    const file = resolve(process.cwd(), args.file)\n    if (!existsSync(file)) {\n      consola.error(`File not found: ${file}`)\n      process.exit(1)\n    }\n\n    const isTs = file.endsWith('.ts') || file.endsWith('.tsx') || file.endsWith('.mts')\n    const nodeArgs = isTs\n      ? ['--experimental-strip-types', '--no-warnings=ExperimentalWarning', file]\n      : [file]\n\n    consola.info(`Starting MCP server: ${file}`)\n\n    const child = spawn(process.execPath, nodeArgs, {\n      stdio: 'inherit',\n      env: process.env,\n    })\n\n    child.on('exit', (code) => {\n      process.exit(code ?? 0)\n    })\n\n    const forward = (signal: NodeJS.Signals): void => {\n      if (!child.killed)\n        child.kill(signal)\n    }\n    process.on('SIGINT', () => forward('SIGINT'))\n    process.on('SIGTERM', () => forward('SIGTERM'))\n  },\n})\n","import { spawn } from 'node:child_process'\nimport { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport process from 'node:process'\nimport { defineCommand } from 'citty'\nimport { consola } from 'consola'\n\n/**\n * `bridgent inspect <file>` is a thin wrapper around the official MCP Inspector.\n *\n * It spawns Inspector via `pnpm dlx` (falling back to `npx -y` if unavailable)\n * and connects it to the user's server file using stdio. The Inspector opens\n * a browser window letting you list tools, send `tools/call`, and see traces.\n *\n * This is intentionally a thin wrapper — Bridgent's own inspector UI ships\n * later as a differentiated experience.\n */\nexport const inspect = defineCommand({\n  meta: {\n    name: 'inspect',\n    description: 'Open MCP Inspector and connect it to your server (stdio).',\n  },\n  args: {\n    file: {\n      type: 'positional',\n      description: 'Path to the server file (TS or JS).',\n      required: true,\n    },\n  },\n  async run({ args }): Promise<void> {\n    const file = resolve(process.cwd(), args.file)\n    if (!existsSync(file)) {\n      consola.error(`File not found: ${file}`)\n      process.exit(1)\n    }\n\n    const isTs = file.endsWith('.ts') || file.endsWith('.tsx') || file.endsWith('.mts')\n    const targetArgs = isTs\n      ? [process.execPath, '--experimental-strip-types', '--no-warnings=ExperimentalWarning', file]\n      : [process.execPath, file]\n\n    consola.info('Starting MCP Inspector …')\n\n    // Prefer pnpm dlx (this monorepo uses pnpm); fall back to npx for users\n    // running outside a pnpm shell.\n    const launcher = pickLauncher()\n    if (!launcher) {\n      consola.error('Neither `pnpm` nor `npx` is on PATH. Install one of them and try again.')\n      process.exit(1)\n    }\n\n    const child = spawn(launcher.cmd, [...launcher.args, '@modelcontextprotocol/inspector', ...targetArgs], {\n      stdio: 'inherit',\n      env: process.env,\n    })\n\n    child.on('exit', (code) => {\n      process.exit(code ?? 0)\n    })\n\n    const forward = (signal: NodeJS.Signals): void => {\n      if (!child.killed)\n        child.kill(signal)\n    }\n    process.on('SIGINT', () => forward('SIGINT'))\n    process.on('SIGTERM', () => forward('SIGTERM'))\n  },\n})\n\nfunction pickLauncher(): { cmd: string, args: string[] } | undefined {\n  // We can't synchronously check $PATH cheaply across platforms; pick by\n  // env hint, then fall back at spawn time. spawn'll throw ENOENT if missing.\n  if (process.env.npm_execpath?.includes('pnpm') || process.env.PNPM_HOME)\n    return { cmd: 'pnpm', args: ['dlx'] }\n  return { cmd: 'npx', args: ['-y'] }\n}\n","import { spawn } from 'node:child_process'\nimport { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport process from 'node:process'\nimport { defineCommand } from 'citty'\nimport { consola } from 'consola'\n\nexport const serve = defineCommand({\n  meta: {\n    name: 'serve',\n    description: 'Run a Bridgent server file (typically using createHttpServer).',\n  },\n  args: {\n    file: {\n      type: 'positional',\n      description: 'Path to the server file (TS or JS).',\n      required: true,\n    },\n  },\n  async run({ args }): Promise<void> {\n    const file = resolve(process.cwd(), args.file)\n    if (!existsSync(file)) {\n      consola.error(`File not found: ${file}`)\n      process.exit(1)\n    }\n\n    const isTs = file.endsWith('.ts') || file.endsWith('.tsx') || file.endsWith('.mts')\n    const nodeArgs = isTs\n      ? ['--experimental-strip-types', '--no-warnings=ExperimentalWarning', file]\n      : [file]\n\n    consola.info(`Starting server: ${file}`)\n\n    const child = spawn(process.execPath, nodeArgs, {\n      stdio: 'inherit',\n      env: process.env,\n    })\n\n    child.on('exit', (code) => {\n      process.exit(code ?? 0)\n    })\n\n    const forward = (signal: NodeJS.Signals): void => {\n      if (!child.killed)\n        child.kill(signal)\n    }\n    process.on('SIGINT', () => forward('SIGINT'))\n    process.on('SIGTERM', () => forward('SIGTERM'))\n  },\n})\n","import { defineCommand, runMain } from 'citty'\nimport { dev } from './commands/dev'\nimport { inspect } from './commands/inspect'\nimport { serve } from './commands/serve'\n\nconst main = defineCommand({\n  meta: {\n    name: 'bridgent',\n    version: '0.0.1',\n    description: 'Expose your existing APIs, databases, and code as MCP servers',\n  },\n  subCommands: {\n    dev,\n    serve,\n    inspect,\n  },\n})\n\nrunMain(main)\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@bridgent/cli",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Bridgent AI CLI — expose any API, database, or code as a production-ready MCP server in one line.",
+  "license": "MIT",
+  "homepage": "https://bridgent.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/js-mark/bridgent.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/js-mark/bridgent/issues"
+  },
+  "keywords": [
+    "bridgent",
+    "bridgent-ai",
+    "mcp",
+    "model-context-protocol",
+    "ai-agent",
+    "cli",
+    "claude-code",
+    "cursor",
+    "codex",
+    "gemini-cli"
+  ],
+  "bin": {
+    "bridgent": "./dist/cli.mjs"
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "dependencies": {
+    "citty": "^0.2.2",
+    "consola": "^3.4.2",
+    "@bridgent/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "tsdown": "^0.22.1",
+    "typescript": "^6.0.3",
+    "vitest": "^3.2.6"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  }
+}