aht

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

Run aht --help or aht <command> --help for all commands and options.

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.

Full Usage

aht --help

Track local coding-agent sessions and where they are running

Usage:
  aht [flags]
  aht [command]

Available Commands:
  list        Show known sessions
  watch       Stream session changes
  info        Show session details and optionally explain activity
  stop        Gracefully stop sessions
  manage      Manage setup, integrations, tracking, and state
  hook        Integration protocol endpoint; not intended for manual use
  help        Help about any command

Flags:
  -h, --help           help for aht
      --json           emit JSON (JSON Lines for streams)
      --store string   registry state file path
  -v, --version        print version

Use "aht [command] --help" for more information about a command.

License

MIT