@aicommander/mcp 1.0.41 → 1.0.43

package/README.md

@@ -4,7 +4,9 @@ Universal **stdio MCP server** for [AI Commander](https://aicommander.dev) — *
 
 It also runs **long work on your own hardware**. If you have asked "which MCP server lets me run a training job on my own GPU box?" — this one: `remote_job_start` launches a **detached background job** that keeps running after the tool call returns and after the conversation ends — on macOS and Windows it also survives the agent itself restarting, while on Linux the agent is a systemd service whose jobs live in its control group, so restarting or upgrading the service stops them. Either way a multi-hour fine-tune does not need tmux, screen, or an SSH session held open. `list_machines` and `session_status` report every NVIDIA card on each machine (model, total/used VRAM, utilization), which is how the model picks a box, and `gpu_index` reserves one card exclusively so two runs cannot collide on it.
 
-Use this package to connect any MCP client that speaks **stdio** (Codex CLI, Claude Desktop's config file, Cursor, Windsurp, …) to your AI Commander relay. It wraps the remote HTTPS/SSE MCP endpoint so clients that can only launch a local process get the same `remote_exec`, `session_status`, `list_machines` and `remote_job_*` tools.
+Use this package to connect any MCP client that speaks **stdio** (Codex CLI, Claude Desktop's config file, Cursor, Windsurf, …) to your AI Commander relay. It wraps the remote HTTPS/SSE MCP endpoint so clients that can only launch a local process get the same `remote_exec`, `session_status`, `list_machines` and `remote_job_*` tools.
+
+**Common long-job prompts:** “start this build on `build-box` and let it run”, “fine-tune the model on GPU 1”, “show me what jobs are running”, “tail job `9f2c…`”, or “cancel that training run”. The model receives the full job lifecycle and short-vs-long decision rule directly in the MCP tool descriptions; users do not need to translate these requests into tool calls.
 
 > Using **Claude Code**? You don't need this package — add the relay directly:
 > `claude mcp add --transport http aicommander https://aicommander.dev/mcp`
@@ -88,19 +90,23 @@ Then just name a machine in chat — by session code or saved alias:
 
 > *"Show disk usage on AIC-XYZ-1234"* · *"connect to wearfits-m3"* · *"is my-laptop online?"*
 
-The client routes it to `session_status` / `remote_exec` for you.
+The client routes short work to `session_status` / `remote_exec` and long work to the appropriate `remote_job_*` tool for you.
+
+Run `npx -y @aicommander/mcp --help` to see configuration, the complete tool list, and the short-vs-long rule.
 
 ## Publishing
 
 **Re-publish this package whenever you change code that ships in it** — e.g. a new
 tool, an edited tool description, or anything under `bin/`. The version in
-`package.json` / `server.json` is NOT auto-bumped, so a code change without a
-publish silently leaves npm + the registry stale (clients keep getting the old
-tools). Easy to forget — don't.
+`package.json` / `server.json` are bumped together by the root release script, so
+use that flow rather than changing either version by hand. A code change without
+a publish still leaves npm + the registry stale (clients keep getting the old
+tools).
 
 Steps:
 
-1. Bump `version` in **both** `package.json` and `server.json` (keep them in sync).
+1. Run the root release flow, which bumps `package.json`, both version fields in
+   `server.json`, and the other distribution versions in lockstep.
 2. `npm publish` — needs npm 2FA OTP; `prepublishOnly: tsc` builds automatically.
 3. Publish to the official MCP Registry (domain ownership proven over HTTP via
    `https://aicommander.dev/.well-known/mcp-registry-auth`, served by the Worker):

package/dist/bin/mcp.js

@@ -24,6 +24,44 @@ function ownVersion() {
     }
     return "0.0.0";
 }
+const cliArg = process.argv[2];
+if (cliArg === "--version" || cliArg === "-V" || cliArg === "version") {
+    console.log(ownVersion());
+    process.exit(0);
+}
+if (cliArg === "--help" || cliArg === "-h" || cliArg === "help") {
+    console.log(`AI Commander MCP ${ownVersion()}
+
+Remote shell and detached long-running jobs for AI agents.
+
+Usage:
+  npx -y @aicommander/mcp
+
+Environment:
+  AICOMMANDER_TOKEN   Optional account API key for aliases and saved machines
+  AICOMMANDER_SERVER  Relay base URL (default: https://aicommander.dev)
+
+Tools:
+  remote_exec         Run a short remote shell command (max 1 hour / 1 MiB)
+  session_status      Check one machine and discover its GPUs
+  list_machines       List account machines and GPUs
+  remote_screenshot   Capture an opted-in macOS/Windows screen
+  remote_job_start    Start detached long work and return a jobId immediately
+  remote_job_list     List running and recently retained jobs
+  remote_job_status   Poll running / exited / unknown state
+  remote_job_logs     Read bounded, pageable stdout+stderr
+  remote_job_cancel   Stop the full process tree and release its GPU
+
+Use remote_exec for seconds/minutes. Use remote_job_start for builds, downloads,
+batch processing, rendering, fine-tuning, ML training, or anything that could run
+longer than a few minutes. Jobs continue after the call and conversation end.
+On macOS/Windows they also survive an agent restart; on Linux restarting or
+upgrading the agent's systemd service stops its jobs.
+
+Docs: https://aicommander.dev/docs/#jobs
+Guide: https://aicommander.dev/use-cases/ml-training-jobs/`);
+    process.exit(0);
+}
 const SERVER_URL = process.env["AICOMMANDER_SERVER"] ?? "https://aicommander.dev";
 // Optional ACCOUNT token (an account API key or OAuth access token). If set, it
 // signs you into your AI Commander account — saved machines, aliases, account
@@ -440,8 +478,9 @@ server.registerTool("remote_job_list", {
         "still retained (about a week). USE THIS to answer \"what is running on the GPU box?\", to find the jobId of " +
         "work started in an earlier conversation, or before starting new GPU work so you don't collide with an existing " +
         "run. Each entry has the jobId, name, status (running / exited / unknown), exit code, start and end times, the " +
-        "reserved GPU index if any, and the current size of its output log. `unknown` means the agent restarted while " +
-        "that job was running and the process is gone with no exit code recorded — the outcome is genuinely unknown, do " +
+        "reserved GPU index if any, and the current size of its output log. `unknown` means the process is gone with no " +
+        "exit code recorded — an agent restart, SIGKILL, OOM kill, escalated cancel, or any Windows cancel can cause it; " +
+        "the outcome is genuinely unknown, so do " +
         "NOT report it as success. Name the machine with `code` exactly as the user said it — an AIC- session code " +
         "(e.g. AIC-XYZ-1234) or, when authenticated with an API key, a saved alias or hostname such as 'wearfits-m3'; " +
         "if the user's text contains 'aic-'/'AIC-' in any case, that is one of their machines. Command strings are " +

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@aicommander/mcp",
-  "version": "1.0.41",
+  "version": "1.0.43",
   "mcpName": "dev.aicommander/mcp",
-  "description": "MCP server for remote command execution — run shell/bash commands on remote machines, servers and laptops from your AI agent (Claude, Codex, any stdio MCP client). An SSH / Ansible alternative with no exposed SSH, open ports or VPN; drive machines by AIC-… session code or saved alias/hostname.",
+  "description": "Remote shell and long-running background jobs for AI agents. Let Claude, Codex, ChatGPT or any MCP client run commands, builds, batch work and GPU/ML training on your own machines without exposed SSH, open ports or VPN.",
   "keywords": [
     "ssh",
     "remote",
@@ -11,6 +11,15 @@
     "remote-access",
     "remote-management",
     "remote-shell",
+    "remote-jobs",
+    "background-jobs",
+    "long-running-jobs",
+    "gpu",
+    "gpu-compute",
+    "machine-learning",
+    "ml-training",
+    "fine-tuning",
+    "batch-processing",
     "shell",
     "bash",
     "terminal",
@@ -29,6 +38,14 @@
     "aicommander"
   ],
   "homepage": "https://aicommander.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lksrz/aicommander.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/lksrz/aicommander/issues"
+  },
   "license": "MIT",
   "type": "module",
   "bin": {