pohunek documentation

pohunek is a headless, multihost backbone for coding agents: one small daemon per machine, one durable terminal per agent session, and one versioned JSON contract for everything you build on top. These pages are rendered from the pohunek repository at release v0.35.2.

Read the almanac once. The herd reads it every day.

Start here

Install Release archives, the login service, upgrades and a first session.

Features Everything the core does, the daemon and worker split, and the trust boundary.

Remote hosts Reach daemons on other machines over a NetBird overlay.

Install with your agent Let the coding agent you already use install and verify pohunek.

Learn and build

Sessions Durable PTYs, runtime state, activity, and what survives a restart.

CLI Every command, multihost targeting, automation and notifications.

SDKs Rust and TypeScript clients, connection and event subscriptions.

Protocol The versioned wire protocol behind the CLI and SDKs.

When something breaks

Debug the daemon Find out why the daemon does not start or answer.

Trust model Who pohunek trusts, and what it never does on your behalf.