Harnie Overview
Local-first work-state for coding agents — import, inspect, and hand off across harnesses.
Harnie separates engineering work from the agent that performed it. It reads Pi, OpenCode, and Codex sessions without mutating them, stores observed work in SQLite, and emits Markdown continuation handoffs for cross-agent workflows.
Core loop: Import → Inspect → Handoff
What it does
- Import sessions from Pi, OpenCode, and Codex
- Store observed events and derived claims with provenance
- Inspect work-state with evidence-backed detail
- Generate Markdown handoff packages for a different agent harness
Key concepts
| Concept | Description |
|---|---|
| Observed events | Raw session evidence (bash, edits) — never mutated |
| Derived claims | Goal, findings, next steps — rule-derived with provenance |
| Handoff packages | Markdown continuation for fresh agent sessions |
| Provenance chain | Every claim links back to observed events |
Important limitation
Harnie does not resume sessions natively. It creates continuation context for a fresh agent session — the receiving agent starts clean with structured handoff context, not a session replay.
Tech stack
- Runtime: Node.js 22.23+
- Storage: SQLite (
$HARNIE_HOME/harnie.db) - Distribution: curl install script
- Platforms: macOS and Linux