# 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)]].
<!-- QueryToSerialize: LIST FROM #ai/agents/harnesses AND !#type/quote AND !#type/creation/quote WHERE public_note = true SORT file.name ASC -->
<!-- SerializedQuery: LIST FROM #ai/agents/harnesses AND !#type/quote AND !#type/creation/quote WHERE public_note = true SORT file.name ASC -->
- [[AI Agent Harness]]
- [[Aider]]
- [[Antigravity 2.0]]
- [[Antigravity CLI]]
- [[Antigravity SDK]]
- [[Claude Code]]
- [[Claude Code Auto Mode]]
- [[Claude Code Channels]]
- [[Claude Code Routines]]
- [[Claude Dynamic Workflows]]
- [[Claude Managed Agents]]
- [[Claude Managed Agents Environments]]
- [[Claude Managed Agents Multi-Agent]]
- [[Claude Managed Agents Sessions]]
- [[Claude Opus 4.8 and Dynamic Workflows]]
- [[Cline]]
- [[Codex App]]
- [[Codex CLI]]
- [[Codex Cloud]]
- [[Codex IDE Extension]]
- [[Cook AI Agent]]
- [[Cursor CLI]]
- [[Cursor.com]]
- [[Docker Agent]]
- [[Fabro]]
- [[Gemini CLI]]
- [[GitHub Copilot]]
- [[GitHub Copilot App]]
- [[GitHub Copilot CLI]]
- [[GitHub Copilot SDK]]
- [[Google Antigravity]]
- [[Goose]]
- [[Grok Build]]
- [[Harness Engineering]]
- [[Hermes Agent]]
- [[JetBrains Air]]
- [[Kimi CLI]]
- [[Microsoft Agent Framework]]
- [[OpenAI Agents SDK]]
- [[OpenAI Codex]]
- [[OpenClaude]]
- [[OpenClaw]]
- [[OpenClaw ACP Agents]]
- [[OpenClaw Channels]]
- [[OpenClaw Gateway]]
- [[OpenClaw Hooks]]
- [[OpenClaw Memory System]]
- [[OpenClaw Multi-Agent Routing]]
- [[OpenClaw Nodes]]
- [[OpenClaw Skills]]
- [[OpenClaw Standing Orders]]
- [[OpenClaw Sub-Agents]]
- [[OpenCode]]
- [[OpenWork]]
- [[Paseo]]
- [[Pydantic AI]]
- [[Roo Code]]
- [[Superset]]
- [[Vercel Open Agents]]
- [[Windsurf]]
<!-- SerializedQuery END -->
## References
-
## Related
- [[AI Agents]]
- [[AI Agent Skills]]
- [[Model Context Protocol (MCP)]]
- [[Large Language Models (LLMs)]]
- [[How coding agents work]]
- [[Agentic Engineering]]
- [[AI Subagents]]
- [[AI Agent Orchestration]]
- [[Harness Engineering]]
- [[Context Engineering]]
- [[Agent System Engineering]]
- [[Crabbox]] — remote testbox infrastructure that harnesses can call as a tool