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.

Go library

Use client to read the current user's agent-harness state through the realtime broker, with a durable-registry fallback for one-shot operations:

aht := client.New(client.Config{})
sessions, err := aht.List(ctx, registry.Filter{
    Presence: registry.PresenceLive,
})

Use registry to embed the state reducer and storage engine, and manage to install harness integrations or control background tracking. The harness package provides the supported harness catalog and executable-name matching.

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

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.