README
¶
AHT
AHT (Agent Harness Tracker) tracks coding-agent sessions, activity, processes, and terminal-multiplexer locations through a local realtime broker.
Supported harnesses: claude,
codex, pi,
opencode, omp,
hermes,
openclaw, grok,
cursor, copilot,
cline, kimi-code,
goose,
agy,
kilo,
droid.
Installation
go install github.com/zigai/aht@latest
Prebuilt archives and Linux packages are available from GitHub Releases.
Quick start
Set up harness integrations and start background tracking:
aht manage setup claude codex
View sessions:
aht list
aht watch
aht info <session>
aht info <session> --explain
Check the installation:
aht manage doctor
Documentation
- Configuration — Configuration file (
config.toml), options reference, and environment overrides - CLI Reference — Command-line interface usage, commands, and flags
- Go Library — Package guide, client API, and Go integration examples
Hook Installation
aht manage integrations install <harness>
aht manage integrations install all
aht manage integrations install codex --dry-run --show-content
<harness> is a supported harness name from the list above.
License
Documentation
¶
Overview ¶
Command aht tracks coding-agent sessions, activity, processes, and terminal locations through a local realtime broker.
Install aht with:
go install github.com/zigai/aht@latest
Run aht --help for commands and options. Go programs can read live state through package client, embed the state engine through package registry, and manage integrations and background tracking through package manage.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
command
Package command runs local inspection commands with bounded resources.
|
Package command runs local inspection commands with bounded resources. |
|
tools/compatibility
command
Command compatibility detects harness releases and runs CI installation tasks.
|
Command compatibility detects harness releases and runs CI installation tasks. |
|
pkg
|
|
|
aht
Package aht provides the primary high-level API for inspecting, filtering, and streaming agent-harness sessions tracked by AHT.
|
Package aht provides the primary high-level API for inspecting, filtering, and streaming agent-harness sessions tracked by AHT. |
|
broker
Package broker provides a lightweight client and wire protocol for communicating with the local AHT realtime broker over a Unix domain socket.
|
Package broker provides a lightweight client and wire protocol for communicating with the local AHT realtime broker over a Unix domain socket. |
|
client
Package client provides access to the current user's AHT agent-session state.
|
Package client provides access to the current user's AHT agent-session state. |
|
harness
Package harness exposes the stable catalog of agent harnesses recognized by AHT.
|
Package harness exposes the stable catalog of agent harnesses recognized by AHT. |
|
herdr
Package herdr discovers and inspects Herdr terminal multiplexer environments.
|
Package herdr discovers and inspects Herdr terminal multiplexer environments. |
|
manage
Package manage provides programmatic management of local AHT integrations and background tracking.
|
Package manage provides programmatic management of local AHT integrations and background tracking. |
|
mux
Package mux defines common types and helpers for terminal multiplexers.
|
Package mux defines common types and helpers for terminal multiplexers. |
|
registry
Package registry models and stores coding-agent harness state.
|
Package registry models and stores coding-agent harness state. |
|
tmux
Package tmux discovers and inspects tmux terminal multiplexer environments.
|
Package tmux discovers and inspects tmux terminal multiplexer environments. |
|
zellij
Package zellij discovers and inspects Zellij terminal multiplexer environments.
|
Package zellij discovers and inspects Zellij terminal multiplexer environments. |