Agent Harness

Agent harness je softwarová vrstva kolem jazykového modelu, která z něj dělá agenta. Stránka stručně vysvětluje pojem, techniku Ralph loop a shrnuje open-source harness nástroje.

Co je harness

Model sám o sobě je bezstavový a umí jen generovat text. Harness mu dodává všechno ostatní — platí zjednodušená rovnice agent = model + harness (Wikipedia):

Řídicí smyčka — posílá modelu kontext, provede akce, které si vyžádá, a vrátí mu výsledky
Nástroje — práce se soubory, shell, vyhledávání, MCP servery
Kontext a paměť — historie konverzace, komprese dlouhých sessions, trvalá paměť mezi sessions
Bezpečnost — oprávnění, schvalování akcí, sandbox

Typickým harnessem je Claude Code, Codex nebo Oh My Pi. Rozlišuje se inner harness od výrobce modelu a outer harness, který si nad ním skládá uživatel z vlastní konfigurace, skriptů a smyček (Wikipedia). Nástroje níže jsou většinou outer harnessy — obalují existující CLI agenty.

Ralph loop

Techniku popsal Geoffrey Huntley a pojmenoval ji po Ralphu Wiggumovi ze Simpsonových. V nejjednodušší podobě jde o nekonečnou bash smyčku, která agentovi opakovaně posílá stejný prompt:

while :; do cat PROMPT.md | claude ; done

Hlavní principy:

Jeden úkol na iteraci — šetří kontextové okno
Deterministický backpressure — testy, typy a linter odmítnou nehotovou práci
Selhání jako signál — neúspěch znamená ladit prompt, ne měnit nástroj
Eventual consistency — nedokonalost se vyřeší dalšími průchody

Nejlépe funguje u nových (greenfield) projektů.

Ralph CLI nástroje

Ralph — CLI pro dlouho běžící vývoj podle PRD: ralph init založí konfiguraci, ralph run spustí smyčku, která rozloží feature na úkoly, po každém ověří výsledek (až 3 opakování) a na konci otevře PR na GitHubu. Pamatuje si kontext mezi sessions, má guardrails (timeouty, detekce zaseknutí) a podporuje Claude Code, Codex CLI a Cursor CLI. TypeScript/Bun, MIT, GitHub.
Terminal window
```
curl -fsSL https://raw.githubusercontent.com/nitodeco/ralph/main/scripts/install.sh | bash
```
Ralph Orchestrator — orchestrátor v Rustu, který koordinuje specializované persony („hats“) přes události a pouští dál jen práci, která projde gates (testy, lint, typecheck). Vestavěné vzory code-assist, debug, research a review; backendy Claude Code, Codex, Gemini CLI, Copilot CLI, Amp, OpenCode, Pi, Kiro a další. MIT.
Terminal window
```
npm install -g @ralph-orchestrator/ralph-cli
```
Open Ralph Wiggum — minimální implementace: ralph "prompt" posílá agentovi stejný prompt, dokud nevypíše <promise>COMPLETE</promise> nebo nedojde na --max-iterations. Podporuje OpenCode (výchozí), Claude Code, Codex, Copilot CLI, Cursor Agent a Qwen Code. TypeScript/Bun, MIT.
Terminal window
```
npm install -g @th0rgal/ralph-wiggum
```
Wiggum CLI — prohledá codebase (stack a konvence), s AI vede rozhovor, ze kterého vytvoří specifikaci, a pak projde cyklus plán → implementace → test → ověření → PR. Příkaz wiggum agent umí sám odbavovat backlog z GitHubu. Pro Claude Code, Codex CLI a další CLI agenty; self-hosted verze je open source (GitHub).
Terminal window
```
npm install -g wiggum-cli
```

Harness frameworky

OpenHarness — open-source harness v Pythonu od HKUDS se 40+ nástroji (soubory, shell, web, MCP), skills ve formátu anthropics/skills, pamětí v MEMORY.md, načítáním CLAUDE.md a automatickou kompresí kontextu. Má režimy oprávnění (Default/Auto/Plan), pravidla pro cesty a příkazy, subagenty a podporu pluginů pro Claude Code. Providery Claude, OpenAI, Copilot, Kimi, GLM, MiniMax a libovolné kompatibilní API. Součástí je osobní agent ohmo pro Slack, Telegram, Discord a Feishu. CLI příkaz oh, MIT.
Terminal window
```
pip install openharness-ai
```
Hermes Agent — self-hosted runtime od Nous Research s trvalou pamětí, samogenerovanými skills a messaging gatewayi.

Pro správu více agentů najednou (paralelní běh, worktrees, vzdálené stroje) viz Coding Agent Tools — patří tam i Harness od Autonomous.

Sources

best-of-Agent-Harnesses — seřazený seznam dalších harnessů (accessed 2026-09-25)