Skip to content
forktty_
Download
Agent HUD

A HUD for agent lifecycle, focus, and resume state.

ForkTTY's Agent HUD turns hook and socket metadata into a scannable overview of active and persisted coding agents. It helps answer which agent is working, which pane owns it, whether it needs input, and whether a session can resume.

Download for LinuxSource repository

Quick start

Install hooks first so sessions publish lifecycle metadata, then inspect HUD-backed rows from the same socket state.

Preview managed hook setup
forktty hooks setup --dry-run
List tracked agents
forktty agents --workspace-name main --json
Explain resume readiness
forktty agent-health --workspace-name main --json
Wait for an attention state
forktty wait agent-status --status needs_input --timeout-ms 30000

Lifecycle without scrollback archaeology

Managed hooks publish provider-neutral status rows for supported agents. ForkTTY groups rows into scan-friendly states such as Working, Needs input, Done, and Idle while keeping diagnostic source and age metadata visible.

Actionable controls

HUD actions can focus a pane, resume a ready persisted session, or forget stale state. The UI highlights current panes and risky permission modes instead of burying them in terminal text.

Loop and team context

When a visible agent surface is bound to workflow loop state, compact chips show iteration and gate status. Team summaries and final states help leaders decide whether a worker is still active, stale, closed, or waiting.

Questions

Which agents appear in the Agent HUD?
Managed hooks cover Codex, Claude Code, Antigravity, and OpenCode. Pi and shell agents can participate through team/provider metadata and explicit status calls.
Is HUD status proof that an agent is live right now?
No. ForkTTY includes lifecycle evidence and freshness metadata so clients can distinguish persisted state from fresh hook output.
Can the HUD resume sessions?
When provider metadata is sufficient and the provider executable is available, Agent Health and HUD resume actions can reopen supported sessions.

Explore related ForkTTY pages

CodexClaude CodeTeam orchestrationDocs

Get the alpha build

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

View releases