Agent harness component in the glas-harness framework of the helix-forge software factory ecosystem.

Find a file

custodian-sync 8a9fdfcd90 chore(consistency): sync task status from DB [auto] Updated by fix-consistency on 2026-07-17: - update .custodian-brief.md for agent-harness		2026-07-17 23:36:05 +02:00
agent_harness	Harness foundation: INTENT, ADR-001, architecture, prototype adoption	2026-07-17 23:35:27 +02:00
docs	Harness foundation: INTENT, ADR-001, architecture, prototype adoption	2026-07-17 23:35:27 +02:00
examples	Harness foundation: INTENT, ADR-001, architecture, prototype adoption	2026-07-17 23:35:27 +02:00
tests	Harness foundation: INTENT, ADR-001, architecture, prototype adoption	2026-07-17 23:35:27 +02:00
workplans	Harness foundation: INTENT, ADR-001, architecture, prototype adoption	2026-07-17 23:35:27 +02:00
.custodian-brief.md	chore(consistency): sync task status from DB [auto]	2026-07-17 23:36:05 +02:00
.gitignore	Initial commit	2026-07-17 21:30:39 +00:00
INTENT.md	Harness foundation: INTENT, ADR-001, architecture, prototype adoption	2026-07-17 23:35:27 +02:00
LICENSE	Initial commit	2026-07-17 21:30:39 +00:00
pyproject.toml	Harness foundation: INTENT, ADR-001, architecture, prototype adoption	2026-07-17 23:35:27 +02:00
README.md	Harness foundation: INTENT, ADR-001, architecture, prototype adoption	2026-07-17 23:35:27 +02:00

README.md

agent-harness

The single shared runtime for unattended agent instances in the Coulomb / Operational Knowledge ecosystem. Projects declare agents (manifest + .kaizen/ state); this harness runs them — blueprint via kaizen-agentic, tasks via activity-core, compute via llm-connect, credentials via OpenBao/ops-warden, reporting to the Custodian State Hub.

Why and boundaries: INTENT.md
Decision + architecture: docs/adr/ADR-001, docs/architecture.md
Current work: workplans/

Usage (prototype)

agent-harness run --task-file examples/task-hello-sandbox.json [--no-hub]
agent-harness mail-scan --target-repo ~/binky-control

Runs exactly one task per invocation: persona bundle (kaizen-agentic schedule prepare) → bounded agentic session (cwd-pinned, hard tool allow-list, never pushes) → commit verification → State Hub progress event + task close.

Tests: PYTHONPATH=".:$HOME/llm-connect" python3 -m pytest tests/ -q