{
 "kind": "mcp",
 "slug": "ai-autonomous-harness-harness",
 "path": "mcp/servers/ai-autonomous-harness-harness/",
 "name": "Harness",
 "maker": "autonomous-ai",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Memory and agent tools",
   "mcp/memory/"
  ]
 ],
 "lead": "start coding agents you can watch.",
 "chips": [
  {
   "label": "Memory and agent tools",
   "path": "mcp/memory/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Local"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add harness -- npx -y @autonomous-ai/harness-mcp"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/autonomous-ai/openharness"
  },
  {
   "label": "Website",
   "href": "https://harness.autonomous.ai/agents"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "claude plugin marketplace add autonomous-ai/openharness --sparse .claude-plugin plugins",
   "note": "The repository autonomous-ai/openharness belongs to Autonomous, the company behind harness.autonomous.ai, and the vendor's own agents page installs the plugin from that repository.",
   "src": "https://harness.autonomous.ai/agents"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "No key needed",
   "status": "yes",
   "sub": "No account",
   "quote": "claude mcp add harness -- npx -y @autonomous-ai/harness-mcp",
   "note": null,
   "src": "https://github.com/autonomous-ai/openharness/blob/f5644bec684e0b98c433acb0253e64674c7ee06e/cli/packages/harness-mcp/README.md"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "On your machine",
   "status": "cond",
   "sub": "Runs code locally: npm, mcpb",
   "note": "",
   "src": "https://github.com/autonomous-ai/openharness"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "Allowed",
   "status": "yes",
   "sub": "MIT license",
   "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
   "note": "MIT license; the tool can be used for paid work.",
   "src": "https://github.com/autonomous-ai/openharness/blob/f5644bec684e0b98c433acb0253e64674c7ee06e/LICENSE"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Harness does",
   "parts": [
    {
     "t": "prose",
     "text": "Harness is a free app that runs coding assistants such as Claude Code and Codex, each in its own terminal window you can watch. With this server your assistant can start another assistant on a task, wait for it and read its answer. You see every one in the Harness app and can answer or stop it."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "A second opinion from another model",
       "text": "While Claude Code builds your feature, it hands a review of the changes to Codex and reads the findings when they are ready.",
       "idea": false
      },
      {
       "title": "Several tasks at the same time",
       "text": "Your assistant splits the work, for example fixing tests in two parts of the project, and starts one helper for each part. It waits for all of them, or for the first one to finish.",
       "idea": false
      },
      {
       "title": "Long jobs that outlast the chat",
       "text": "A slow job, like a long test run, keeps going after your assistant's turn ends, and its answer waits to be read later.",
       "idea": false
      },
      {
       "title": "Use your other computer",
       "text": "Your assistant on the laptop starts a job on your home server or a computer with a strong graphics card, once you have signed in to Harness on both.",
       "idea": false
      },
      {
       "title": "Find what was already decided",
       "text": "Before starting new work, your assistant searches earlier conversations on this computer for what was said about the same problem.",
       "idea": false
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Harness popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "1,511",
       "l": "GitHub stars, autonomous-ai/openharness"
      },
      {
       "n": "104",
       "l": "downloads last week, @autonomous-ai/harness-mcp"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (12)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "harness_whoami",
       "text": "Says which agent is calling, on which machine, and whether it may start harnesses now."
      },
      {
       "name": "harness_list",
       "text": "Lists the harnesses on a machine with their state, who started each and what each is about."
      },
      {
       "name": "harness_search",
       "text": "Searches past and live conversations on this computer by words."
      },
      {
       "name": "harness_machines",
       "text": "Lists the person's machines on the account, to run a harness on another one."
      },
      {
       "name": "harness_start",
       "text": "Starts an agent (Claude Code by default, or Codex and others) on a task in a new project folder or an existing folder."
      },
      {
       "name": "harness_wait",
       "text": "Waits until the named harnesses stop working (45 seconds per call by default, at most 600) and says each one's state."
      },
      {
       "name": "harness_read",
       "text": "Shows a harness's state, the last thing it was asked and its answer."
      },
      {
       "name": "harness_tell",
       "text": "Gives more work to a harness the agent started, only while the person allows it; offered only inside a Harness pane."
      },
      {
       "name": "harness_send",
       "text": "Sends a message to a teammate harness in the same tab while Agent Messages are on; offered only inside a Harness pane."
      },
      {
       "name": "harness_settings",
       "text": "Lists what agents may do here, or turns one of those settings on (only after the person's yes) or off."
      },
      {
       "name": "harness_close",
       "text": "Closes a harness the agent started; its conversation is kept and the person can resume it."
      },
      {
       "name": "harness_setup",
       "text": "The only tool when Harness is not installed; it says how to install it."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "the task text and the files each started agent reads",
       "sub": "To that agent's own provider (for example Anthropic for Claude Code, OpenAI for Codex); every time a harness is started or given work. Opt out: do not start harnesses; the agent does the work itself."
      },
      {
       "l": "Sends",
       "v": "terminal traffic between your machines, end-to-end encrypted",
       "sub": "To directly between machines, or through Cloudflare TURN or the Harness relay when a direct path is blocked; only when you sign in and use harnesses on another machine. Opt out: keep harnesses on this computer; no account is needed then."
      }
     ]
    },
    {
     "t": "prose",
     "text": "The app and this server are open source under the MIT license, so you can use them for paid work. Keep the license notice if you pass the code on. The agents you start bill your own Claude or OpenAI plans."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "Yes",
       "status": "yes",
       "sub": "MIT license; the tool can be used for paid work.",
       "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
       "src": "https://github.com/autonomous-ai/openharness/blob/f5644bec684e0b98c433acb0253e64674c7ee06e/LICENSE"
      },
      {
       "l": "client-work",
       "v": "Yes",
       "status": "yes",
       "sub": "MIT license, no limit on who you do the work for.",
       "quote": "Permission is hereby granted, free of charge, to any person obtaining a copy",
       "src": "https://github.com/autonomous-ai/openharness/blob/f5644bec684e0b98c433acb0253e64674c7ee06e/LICENSE"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "Passing the code on is allowed with the MIT copyright and permission notice kept; bundled upstream tools keep their own licenses.",
       "quote": "MIT license; upstream tools keep their own.",
       "src": "https://github.com/autonomous-ai/openharness/blob/f5644bec684e0b98c433acb0253e64674c7ee06e/README.md"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "0.4.20 in the registry, updated Oct 19, 2026"
      },
      {
       "l": "Last release",
       "v": "npm @autonomous-ai/harness-mcp 0.2.0 (2026-10-19); the registry lists 0.4.20 with harness-mcp.mcpb in release v0.4.20_cli"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Harness",
       "me": true,
       "facts": [
        "1,511 stars",
        "Local"
       ]
      },
      {
       "name": "Ruflo",
       "why": "Pick it if you want agent swarms with shared memory and hooks instead of watched sessions",
       "path": "mcp/servers/io-github-ruvnet-ruflo/",
       "facts": [
        "82K stars",
        "Local",
        "in 17 projects"
       ]
      },
      {
       "name": "io-github-plastic-labs-honcho",
       "why": "Pick it if you need memory that carries across your agent's sessions",
       "path": null,
       "facts": [
        "Local"
       ]
      }
     ],
     "more": "All memory and agent tools servers",
     "more_path": "mcp/memory/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Use the Harness tools to start a Codex reviewer on this branch, wait for it, show me its findings and close it; call harness_whoami first and ask me before changing any Harness setting."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add harness -- npx -y @autonomous-ai/harness-mcp"
      },
      {
       "tab": "npm (stdio)",
       "code": "npx -y @autonomous-ai/harness-mcp"
      },
      {
       "tab": "Cursor",
       "code": "{ \"mcpServers\": { \"harness\": { \"command\": \"npx\", \"args\": [\"-y\", \"@autonomous-ai/harness-mcp\"] } } }"
      }
     ]
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Start a harness for every small edit",
       "fix": "Do quick work yourself (or with your own sub-agents); start a harness only for parallel, long or second-opinion work",
       "why": "Each harness spends the person's tokens."
      },
      {
       "dont": "harness_start with folder set to your own working folder",
       "fix": "harness_start with a project name, so Harness makes and trusts ~/harnesses/<name>",
       "why": "A folder Harness did not make makes Claude Code or Codex ask the person to trust it, and the harness waits."
      },
      {
       "dont": "Retry a refused harness_start, or call harness_settings with person_said_yes without asking",
       "fix": "Tell the person what was refused; turn a setting on only after their explicit yes in chat",
       "why": "Refusals are final and settings are the person's consent to give."
      },
      {
       "dont": "Treat a harness_wait that returns \"Still working\" as a failure",
       "fix": "Call harness_wait again; one call waits 45 seconds unless timeout_seconds says otherwise (600 at most)",
       "why": "The wait is kept short so clients such as Codex do not end the call; the vendor page still says 120 seconds."
      },
      {
       "dont": "Two harnesses editing the same files",
       "fix": "Give each harness its own folder, files or git worktree",
       "why": "Two agents on one file overwrite each other's work."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I need an account?",
       "a": "Not for harnesses on this computer. You sign in only to let agents start harnesses, to use your other machines and the phone app.",
       "evidence": {
        "url": "https://harness.autonomous.ai/agents",
        "quote": "No account is needed for the harnesses the person starts on this computer"
       }
      },
      {
       "q": "What happens if Harness is not installed?",
       "a": "The server still starts but offers only one tool, harness_setup, which explains how to install Harness.",
       "evidence": {
        "url": "https://github.com/autonomous-ai/openharness/blob/f5644bec684e0b98c433acb0253e64674c7ee06e/cli/packages/harness-mcp/README.md",
        "quote": "Where Harness is not installed, the server offers one tool, harness_setup, that says how to install it."
       }
      },
      {
       "q": "Can my assistant close or take over harnesses I started myself?",
       "a": "No. An agent may give work to, and close, only the harnesses it started.",
       "evidence": {
        "url": "https://github.com/autonomous-ai/openharness/blob/f5644bec684e0b98c433acb0253e64674c7ee06e/cli/packages/harness-mcp/README.md",
        "quote": "An agent may give work to, and close, only the harnesses it started."
       }
      },
      {
       "q": "Is the conversation lost when a harness is closed?",
       "a": "No. It is kept and you can resume it.",
       "evidence": {
        "url": "https://github.com/autonomous-ai/openharness/blob/f5644bec684e0b98c433acb0253e64674c7ee06e/cli/src/agentClient/mcp.ts",
        "quote": "Its conversation is kept: the person can resume it."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "ai.autonomous.harness/harness"
  ],
  [
   "Category",
   "Memory and agent tools"
  ],
  [
   "Version",
   "0.4.20"
  ],
  [
   "Package",
   "npm @autonomous-ai/harness-mcp, mcpb https://github.com/autonomous-ai/openharness/releases/download/v0.4.20_cli/harness-mcp.mcpb"
  ],
  [
   "License",
   "MIT"
  ],
  [
   "GitHub",
   "autonomous-ai/openharness"
  ],
  [
   "In the registry since",
   "Oct 19, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "Every helper it starts uses your own Claude or Codex plan and spends your tokens, so it suits long or parallel work, not quick edits.",
  "Only you can let your assistant start helpers. You sign in and turn on the setting \"Agents can start other agents\", which is off by default.",
  "Once installed, Harness adds its own commands to the permission rules of Claude Code and Codex, so they run without asking you."
 ],
 "checked_line": "Read by AgentGid from 9 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/autonomous-ai.png"
}