nubase_cli 0.1.6 → 0.1.7

package/README.md

@@ -16,7 +16,7 @@ Installing skills starts a one-time browser authorization session and prints an
 npx -y nubase_cli@latest install-skills
 ```
 
-This installs the bundled Claude/Codex skills into your user skill directories, writes project MCP config for Claude Code, and starts browser authorization. Open the printed URL, sign in to Studio, choose a project, and approve. The URL includes a per-session UUID and points back to the temporary localhost callback started by the install command. After approval, the CLI writes project-local `.nubase/config.json` and closes the localhost callback server.
+This installs the bundled Claude/Codex skills into your user skill directories, writes a local project MCP bridge under `.nubase/mcp-bridge`, writes project MCP config for Claude Code, and starts browser authorization. Open the printed URL, sign in to Studio, choose a project, and approve. The URL includes a per-session UUID and points back to the temporary localhost callback started by the install command. After approval, the CLI writes project-local `.nubase/config.json` and closes the localhost callback server.
 
 Restart Claude Code in the project after installing, then run `/mcp` and confirm `nubase` is connected.
 
@@ -69,11 +69,12 @@ node packages/mcp-bridge/dist/src/index.js
 {
   "mcpServers": {
     "nubase": {
-      "command": "npx",
-      "args": ["-y", "nubase_cli@latest"],
+      "type": "stdio",
+      "command": "node",
+      "args": ["/absolute/project/path/.nubase/mcp-bridge/dist/src/index.js"],
       "env": {
         "NUBASE_AGENT_ID": "claude-code",
-        "NUBASE_CONFIG": ".nubase/config.json"
+        "NUBASE_CONFIG": "/absolute/project/path/.nubase/config.json"
       }
     }
   }
@@ -98,14 +99,15 @@ Targets:
 
 Use `--skills-scope project` to write `.claude/skills/nubase/**` and `.codex/skills/nubase/**` in the current project instead.
 
-By default, when the target includes `claude`, the command also creates or merges project `.mcp.json`:
+By default, when the target includes `claude`, the command also copies the local MCP bridge to `.nubase/mcp-bridge` and creates or merges project `.mcp.json`:
 
 ```json
 {
   "mcpServers": {
     "nubase": {
-      "command": "npx",
-      "args": ["-y", "nubase_cli@latest"],
+      "type": "stdio",
+      "command": "node",
+      "args": ["/absolute/project/path/.nubase/mcp-bridge/dist/src/index.js"],
       "env": {
         "NUBASE_AGENT_ID": "claude-code",
         "NUBASE_CONFIG": "/absolute/project/path/.nubase/config.json"

package/dist/src/index.js

@@ -6,7 +6,7 @@ import { installSkills, parseInstallArgs } from './install-skills.js';
 import { McpStdioServer } from './mcp-stdio.js';
 import { NubaseClient } from './nubase-client.js';
 import { callTool, TOOLS } from './tools.js';
-const CLI_VERSION = '0.1.6';
+const CLI_VERSION = '0.1.7';
 if (process.argv[2] === 'install-skills') {
     const options = parseInstallArgs(process.argv.slice(3));
     const installed = await installSkills(options);
@@ -20,6 +20,9 @@ if (process.argv[2] === 'install-skills') {
         else if (file.endsWith('.gitignore')) {
             console.error(`Ensured Nubase local config is ignored by git: ${file}`);
         }
+        else if (file.includes(`${defaultPathSep()}.nubase${defaultPathSep()}mcp-bridge${defaultPathSep()}`)) {
+            console.error(`Installed Nubase local MCP bridge: ${file}`);
+        }
         else {
             console.error(`Installed Nubase skill: ${file}`);
         }
@@ -80,3 +83,6 @@ const server = new McpStdioServer(async (request) => {
     }
 });
 server.start();
+function defaultPathSep() {
+    return process.platform === 'win32' ? '\\' : '/';
+}

package/dist/src/install-skills.js

@@ -1,4 +1,4 @@
-import { cp, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { cp, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -19,11 +19,16 @@ export async function installSkills(options) {
         }
     }
     const mcpTargets = resolveMcpTargets(options.mcp ?? 'claude', targets);
+    let mcpCommand = null;
+    if (mcpTargets.length > 0) {
+        mcpCommand = await installProjectMcpBridge(options.projectDir);
+        installed.push(mcpCommand.entrypoint);
+    }
     if (mcpTargets.includes('claude')) {
-        installed.push(await installClaudeMcpConfig(options.projectDir, configPath));
+        installed.push(await installClaudeMcpConfig(options.projectDir, configPath, mcpCommand));
     }
     if (mcpTargets.includes('codex')) {
-        installed.push(await installCodexMcpConfig(options.projectDir, configPath));
+        installed.push(await installCodexMcpConfig(options.projectDir, configPath, mcpCommand));
     }
     installed.push(await ensureProjectGitignore(options.projectDir));
     return installed;
@@ -99,9 +104,11 @@ export function parseInstallArgs(argv) {
     return { target, projectDir, authorize, authArgs, skills, skillsScope, mcp, configPath };
 }
 function bundledSkillDir() {
+    return path.join(bundledPackageRoot(), 'skills', 'nubase');
+}
+function bundledPackageRoot() {
     const here = path.dirname(fileURLToPath(import.meta.url));
-    const packageRoot = path.resolve(here, '..', '..');
-    return path.join(packageRoot, 'skills', 'nubase');
+    return path.resolve(here, '..', '..');
 }
 function skillDestDir(target, scope, projectDir, homeDir) {
     if (scope === 'project') {
@@ -119,15 +126,30 @@ function resolveMcpTargets(mcp, skillTargets) {
     const requested = mcp === 'both' ? ['claude', 'codex'] : [mcp];
     return requested.filter((target) => skillTargets.includes(target));
 }
-async function installClaudeMcpConfig(projectDir, nubaseConfigPath) {
+async function installProjectMcpBridge(projectDir) {
+    const packageRoot = bundledPackageRoot();
+    const destRoot = path.join(projectDir, '.nubase', 'mcp-bridge');
+    await rm(destRoot, { recursive: true, force: true });
+    await mkdir(destRoot, { recursive: true, mode: 0o700 });
+    await cp(path.join(packageRoot, 'dist', 'src'), path.join(destRoot, 'dist', 'src'), { recursive: true, force: true });
+    await cp(path.join(packageRoot, 'skills'), path.join(destRoot, 'skills'), { recursive: true, force: true });
+    await cp(path.join(packageRoot, 'package.json'), path.join(destRoot, 'package.json'), { force: true });
+    const entrypoint = path.join(destRoot, 'dist', 'src', 'index.js');
+    return {
+        command: 'node',
+        args: [entrypoint],
+        entrypoint,
+    };
+}
+async function installClaudeMcpConfig(projectDir, nubaseConfigPath, mcpCommand) {
     const mcpConfigPath = path.join(projectDir, '.mcp.json');
     const config = await readProjectMcpConfig(mcpConfigPath);
     config.mcpServers = {
         ...(config.mcpServers ?? {}),
         nubase: {
             type: 'stdio',
-            command: 'npx',
-            args: ['-y', 'nubase_cli@latest'],
+            command: mcpCommand?.command ?? 'npx',
+            args: mcpCommand?.args ?? ['-y', 'nubase_cli@latest'],
             env: {
                 NUBASE_AGENT_ID: 'claude-code',
                 NUBASE_CONFIG: nubaseConfigPath,
@@ -137,11 +159,11 @@ async function installClaudeMcpConfig(projectDir, nubaseConfigPath) {
     await writeFile(mcpConfigPath, `${JSON.stringify(config, null, 2)}\n`, 'utf8');
     return mcpConfigPath;
 }
-async function installCodexMcpConfig(projectDir, nubaseConfigPath) {
+async function installCodexMcpConfig(projectDir, nubaseConfigPath, mcpCommand) {
     const configPath = path.join(projectDir, '.codex', 'config.toml');
     await mkdir(path.dirname(configPath), { recursive: true });
     const existing = await readTextIfExists(configPath);
-    const block = codexMcpBlock(nubaseConfigPath);
+    const block = codexMcpBlock(nubaseConfigPath, mcpCommand);
     const next = upsertCodexMcpBlock(existing, block);
     await writeFile(configPath, next, 'utf8');
     return configPath;
@@ -166,12 +188,14 @@ async function readTextIfExists(filePath) {
         throw err;
     }
 }
-function codexMcpBlock(configPath) {
+function codexMcpBlock(configPath, mcpCommand) {
+    const command = mcpCommand?.command ?? 'npx';
+    const args = mcpCommand?.args ?? ['-y', 'nubase_cli@latest'];
     return [
         '[mcp_servers.nubase]',
         'type = "stdio"',
-        'command = "npx"',
-        'args = ["-y", "nubase_cli@latest"]',
+        `command = "${escapeTomlString(command)}"`,
+        `args = [${args.map((arg) => `"${escapeTomlString(arg)}"`).join(', ')}]`,
         'startup_timeout_sec = 30',
         '',
         '[mcp_servers.nubase.env]',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nubase_cli",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "private": false,
   "type": "module",
   "bin": {

package/skills/nubase/SKILL.md

@@ -67,6 +67,7 @@ By default this writes:
 - `~/.claude/skills/nubase/**`
 - `~/.codex/skills/nubase/**`
 - project `.mcp.json` with a `nubase` stdio MCP server for Claude Code
+- project `.nubase/mcp-bridge/**` local MCP bridge runtime, so agent startup does not depend on `npx @latest`
 - project `.nubase/config.json` after browser authorization
 
 After installing, restart Claude Code in the project and run `/mcp`. The `nubase` server must be connected before this skill can call `nubase_overview`, `memory_context`, or other MCP tools.
@@ -77,11 +78,12 @@ Expected `.mcp.json` shape:
 {
   "mcpServers": {
     "nubase": {
-      "command": "npx",
-      "args": ["-y", "nubase_cli@latest"],
+      "type": "stdio",
+      "command": "node",
+      "args": ["/absolute/project/path/.nubase/mcp-bridge/dist/src/index.js"],
       "env": {
         "NUBASE_AGENT_ID": "claude-code",
-        "NUBASE_CONFIG": ".nubase/config.json"
+        "NUBASE_CONFIG": "/absolute/project/path/.nubase/config.json"
       }
     }
   }