HZL

<img src="./assets/hzl.png" alt="HZL mascot" width="320" />

A durable shared task ledger for OpenClaw and other multi-agent systems. Agents wake into fresh sessions — HZL preserves continuity across those wakes so they can resume work, hand off context, and coordinate through shared project pools.

Install

npm install -g hzl-cli    # or: brew tap tmchow/hzl && brew install hzl
hzl init

Documentation

Full docs at hzl-tasks.com

• Getting Started — installation, quickstart, agent setup
• Concepts — tasks, dependencies, claiming & leases, lifecycle hooks, cloud sync
• Workflows — single-agent, multi-agent, handoffs, oversight
• Dashboard — Kanban board, agent operations, graph view
• CLI Reference
• Hooks Reference — configuration, payloads, delivery semantics
• Architecture
• Troubleshooting

Orchestrator Primitives

HZL stays on the ledger side of the boundary. OpenClaw or another orchestrator should subscribe, poll, and decide what to do:

hzl events --follow              # raw NDJSON lifecycle feed
hzl stats --window 1h            # raw operational counters
hzl task stuck --json --stale    # recovery polling surface
hzl hook drain                   # deliver durable on_done hooks

Links

• Contributing
• Changelog

License

MIT