@autonomous-ai/harness-mcp 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# @autonomous-ai/harness-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[Harness](https://harness.autonomous.ai/agents) as an MCP server, for clients that install servers from npm.
+
+Harness runs coding agents (Claude Code, Codex) in sessions of their own, on this computer or the person's other
+machines, and the person can watch and join every one in the Harness app. With this server an agent can start
+harnesses, wait for them, read their answers and close them:
+
+| Tool | What it does |
+|---|---|
+| `harness_whoami` | who you are to Harness, and whether you may start harnesses now: call it first |
+| `harness_list` | the harnesses here: state, who started each, what each is about |
+| `harness_start` | start an agent on a task in a folder or a new project, by name |
+| `harness_wait` | wait until harnesses stop working |
+| `harness_read` | a harness's last ask and its answer |
+| `harness_close` | close a harness you started |
+
+An agent may give work to, and close, only the harnesses it started.
+
+## Install
+
+Harness itself (macOS or Linux; no account needed for harnesses on this computer):
+
+```
+curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash
+harness start
+```
+
+On Linux the installer installs tmux and curl with apt-get, which asks for your password (or run
+`sudo apt-get install -y tmux curl` first).
+
+Then add the server to your client, for example:
+
+```
+claude mcp add harness -- npx -y @autonomous-ai/harness-mcp
+```
+
+```json
+{ "mcpServers": { "harness": { "command": "npx", "args": ["-y", "@autonomous-ai/harness-mcp"] } } }
+```
+
+This package runs `harness mcp` from the installed CLI (or `HARNESS_BIN`). Where Harness is not installed, the
+server offers one tool, `harness_setup`, that says how to install it.
+
+Claude Code and Codex can also install the Harness plugin, which brings a skill with it: see
+[harness.autonomous.ai/agents](https://harness.autonomous.ai/agents).
+
+MIT licensed. Source: [autonomous-ai/openharness](https://github.com/autonomous-ai/openharness/tree/main/cli/packages/harness-mcp).

package/bin.mjs

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { findHarness, runHarness, serveSetup } from './index.mjs'
+
+const harness = findHarness()
+if (harness) process.exitCode = await runHarness(harness)
+else await serveSetup()

package/index.mjs

@@ -0,0 +1,99 @@
+/**
+ * `npx -y @autonomous-ai/harness-mcp`: Harness's MCP server for clients that install servers from npm. Harness is
+ * not an npm package (its installer brings its own Node and tmux, cli/scripts/install.sh), so this finds the
+ * `harness` command and runs `harness mcp` in its place. Where Harness is not installed it still answers, with one
+ * tool that says how to install it: an agent that found Harness in a directory can then ask its person to.
+ *
+ * No dependencies: it runs before anything is installed.
+ */
+import { spawn } from 'node:child_process'
+import { accessSync, constants } from 'node:fs'
+import { homedir } from 'node:os'
+import { delimiter, join } from 'node:path'
+import { createInterface } from 'node:readline'
+
+export const INSTALL = 'curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash'
+
+/** Where `harness` is: HARNESS_BIN, else the PATH, else where the installer links it (a client may start this with
+ *  a PATH that leaves out ~/.local/bin). */
+export function findHarness(env = process.env, home = homedir(), executable = isExecutable) {
+  const candidates = [
+    env.HARNESS_BIN,
+    ...(env.PATH ?? '').split(delimiter).filter(Boolean).map((dir) => join(dir, 'harness')),
+    join(home, '.local', 'bin', 'harness'),
+  ].filter(Boolean)
+  return candidates.find((path) => executable(path)) ?? null
+}
+
+function isExecutable(path) {
+  try { accessSync(path, constants.X_OK); return true } catch { return false }
+}
+
+const SETUP_TEXT = (platform) => platform === 'win32'
+  ? 'Harness runs on macOS and Linux. On Windows, install it inside WSL, and run this server from there.'
+  : [
+    'Harness is not installed on this computer. It runs coding agents (Claude Code, Codex) in sessions of their own that the person can watch, and gives you tools to start, wait for, read and close them.',
+    '',
+    'To install it, ask the person, then run:',
+    `  ${INSTALL}`,
+    '  harness start',
+    '',
+    'Then restart this MCP server (or your client) to get the Harness tools, and call harness_whoami: it says whether you may start harnesses.',
+    'Only the person can let you: they sign in (harness login, in a browser) and turn on "Agents can start other agents"',
+    '(Settings ▸ Experimental, or harness settings agents-start-agents on in their own terminal). Ask them; until then, do the work yourself.',
+    'More: https://harness.autonomous.ai/agents',
+  ].join('\n')
+
+/** The answer to one JSON-RPC message while Harness is not installed, or null for a notification. */
+export function setupAnswer(message, platform = process.platform) {
+  const id = message?.id
+  const isRequest = id !== undefined && id !== null
+  const reply = (result) => ({ jsonrpc: '2.0', id, result })
+  switch (message?.method) {
+    case 'initialize':
+      return reply({
+        protocolVersion: typeof message.params?.protocolVersion === 'string' ? message.params.protocolVersion : '2025-06-18',
+        capabilities: { tools: {} },
+        serverInfo: { name: 'harness', title: 'Harness (not installed)', version: '0.1.0' },
+        instructions: SETUP_TEXT(platform),
+      })
+    case 'ping': return reply({})
+    case 'tools/list':
+      return reply({ tools: [{
+        name: 'harness_setup',
+        description: 'Harness is not installed here. Call this for how to install it, which gives you tools to start, wait for, read and close other coding agents.',
+        inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+        annotations: { readOnlyHint: true },
+      }] })
+    case 'tools/call':
+      if (message.params?.name !== 'harness_setup') return { jsonrpc: '2.0', id, error: { code: -32602, message: `Unknown tool: ${String(message.params?.name)}` } }
+      return reply({ content: [{ type: 'text', text: SETUP_TEXT(platform) }] })
+    default:
+      return isRequest ? { jsonrpc: '2.0', id, error: { code: -32601, message: `Method not found: ${String(message?.method)}` } } : null
+  }
+}
+
+/** Serve [setupAnswer] on newline-delimited JSON-RPC until the input ends. */
+export async function serveSetup(input = process.stdin, output = process.stdout, platform = process.platform) {
+  for await (const line of createInterface({ input, crlfDelay: Infinity })) {
+    if (!line.trim()) continue
+    let message
+    try { message = JSON.parse(line) } catch {
+      output.write(`${JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } })}\n`)
+      continue
+    }
+    const reply = setupAnswer(message, platform)
+    if (reply) output.write(`${JSON.stringify(reply)}\n`)
+  }
+}
+
+/** Run `harness mcp` in this process's place: its stdio, its exit, and the signals a client stops it with. */
+export function runHarness(path, run = spawn) {
+  return new Promise((done) => {
+    const child = run(path, ['mcp'], { stdio: 'inherit' })
+    const forward = (signal) => () => child.kill(signal)
+    for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) process.on(signal, forward(signal))
+    child.on('error', () => done(1))
+    child.on('exit', (code, signal) => done(code ?? (signal ? 1 : 0)))
+  })
+}

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "@autonomous-ai/harness-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Harness as an MCP server: start, wait for, read and close Claude Code and Codex agents the person can watch.",
+  "mcpName": "ai.autonomous.harness/harness",
+  "type": "module",
+  "bin": {
+    "harness-mcp": "bin.mjs"
+  },
+  "exports": "./index.mjs",
+  "files": [
+    "bin.mjs",
+    "index.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["mcp", "mcp-server", "agents", "claude-code", "codex", "parallel", "harness"],
+  "homepage": "https://harness.autonomous.ai/agents",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/autonomous-ai/openharness.git",
+    "directory": "cli/packages/harness-mcp"
+  },
+  "license": "MIT"
+}