Skip to content
forktty_
Download
Agent HUD

A small HUD for lifecycle and focus.

Optional hooks turn agent lifecycle events into a scannable list. The HUD helps locate a pane or resume a supported session without becoming a team or workflow engine.

Download for LinuxSource repository

Quick start

Install hooks manually if you want lifecycle metadata.

Preview hook setup
forktty hooks setup --dry-run
List tracked agents
forktty agents --json
Inspect resume readiness
forktty agent-health --json

Lifecycle without tail scraping

Supported hooks publish running, needs-input, idle, and ended metadata with source and freshness information.

Narrow controls

The HUD can focus a pane, inspect health, forget stale state, or resume a supported session.

Optional by design

ForkTTY remains a fully functional terminal when hooks are absent. Setup and updates are always explicit.

Questions

Which agents can publish hook state?
The bundled manual setup targets Codex, Claude Code, Antigravity, and OpenCode.
Is persisted status proof an agent is live?
No. Source and age metadata distinguish saved lifecycle state from fresh events.
Does the HUD coordinate teams?
No. It is a thin lifecycle, focus, and resume surface.

Explore related ForkTTY pages

CodexClaude CodeGhostty terminalDocs

Get the alpha build

AppImage and .deb packages are published on GitHub Releases for Linux x86_64.

View releases