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, and
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
|
|
|
brokerapi
Package brokerapi defines the local realtime registry protocol and Go client.
|
Package brokerapi defines the local realtime registry protocol and Go client. |
|
pkg
|
|
|
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. |
|
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. |
|
registry
Package registry models and stores coding-agent harness state.
|
Package registry models and stores coding-agent harness state. |