AI Agent Harness

An AI agent harness is a tool or environment that wraps an AI model and exposes it as an interactive agent; giving it access to tools (file system, shell, browser, APIs, messaging), a conversation loop, and context about its operating environment. The harness handles the orchestration; routing tool

Canonical version: AI Agent Harness.

An AI agent harness is a tool or environment that wraps an AI model and exposes it as an interactive agent; giving it access to tools (file system, shell, browser, APIs, messaging), a conversation loop, and context about its operating environment. The harness handles the orchestration; routing tool calls, managing context windows, streaming output, persisting state, applying permission profiles.

Most early harnesses were coding-focused (Claude Code, Codex CLI, Aider), but the category now spans coding, personal-assistant, and managed-cloud variants. Hermes Agent and OpenClaw are personal-assistant harnesses with messaging gateways and skill learning loops; Codex Cloud and Claude Managed Agents are managed-cloud variants where the agent runs server-side. The pattern is the same, but their orientation is not.

The term distinguishes the harness (the scaffolding around the model) from the model itself. The same harness can often work with multiple models; the same model can be driven by multiple harnesses. Although it's not a given. I've tried using Claude Code at work against different models (e.g., GPT 5.4) and it was a disaster ;-)

Common capabilities

  • Read/write files and execute shell commands
  • Search codebases (grep, AST, LSP)
  • Run tests and linters
  • Browser/web access
  • Model Context Protocol (MCP) tool integration
  • Git operations (commits, PRs, diffs)
  • Multi-agent coordination (subagents, parallel workers)
  • Persistent memory and context files (e.g., CLAUDE.md, AGENTS.md)

Harnesses I've taken notes about

The detailed map is at AI Agent Harnesses (MoC).

References


About Sébastien

I'm Sébastien Dubois, and I'm on a mission to help knowledge workers escape information overload. After 20+ years in IT and seeing too many brilliant minds drowning in digital chaos, I've decided to help people build systems that actually work. Through the Knowii Community, my courses, products & services and my Website/Newsletter, I share practical and battle-tested systems.

I write about Knowledge Work, Personal Knowledge Management, Note-taking, Lifelong Learning, Personal Organization, Productivity, and more. I also craft lovely digital products and tools.

If you want to follow my work, then become a member and join our community.

Ready to get to the next level?

If you're tired of information overwhelm and ready to build a reliable knowledge system:

Found this valuable? Share it with someone who needs it.

Join 6,000+ readers. Get practical systems for knowledge & AI. Free.

Subscribe ✨

Free: Knowledge System Checklist

A clear roadmap to building your own knowledge system. Subscribe and get it straight to your inbox.

6,000+ readers. No spam. Unsubscribe anytime.