Earendil (the team behind the Pi harness) writes the explainer for anyone who’s been too embarrassed to ask what an “agent harness” is. The frame: the climbing harness — straps that support you, connect you to the rope, and carry the tools you rack up. Agent harnesses work the same way: they’re the gear that straps a model to your climb.

What an agent harness is

A piece of software that provides an environment for an AI model to operate within — and the one part of the AI stack you, the end user, can actually own. Simplistically: Agent = Model + Harness.

Harnesses generally do four things:

  • System prompt — the instruction set governing how the model responds, injected with every prompt. Like a first-day briefing, not an embedded “soul.”
  • Tools — capabilities written in code that the model can call (web search, write code, compose email). The harness describes and provides them but doesn’t dictate when they’re used — the model decides.
  • The agentic loop — the framework where the model assesses results, decides to search again or iterate, and closes the loop when the job is done (the worked example: compare local schools → search → build a spreadsheet → compose the email).
  • Translation layer — what lets one harness work with many models (Anthropic, OpenAI, open weights), and sometimes mix models within a single loop.

Why the harness is the political part

The translation layer delivers control to the end user: own the harness, keep your sessions locally, compare models by cost and results in one place. “This translation layer helps take power and leverage away from the AI labs and into the hands of end users.”

  • The first popular harness, Claude Code, wasn’t neutral — it was built to enable coding with Claude on your machine.
  • The open-source wave since: OpenClaw, OpenCode, Hermes, and Pi — harnesses you can own, adapt, and extend (Pi users have shared 5,000+ extensions).
  • The agency argument: if people can run their own harnesses locally, they retain the freedom to make the tools their own — “we wield the hammer, the hammer does not wield us.”

The reminder buried in the analogy: the model is the athlete, but the harness is what you bring to the climb — and it’s the part you can modify, own, and take with you.