Skip to content
AgentCTX

actx top

actx top

Section titled “actx top”

A real-time TUI (Terminal User Interface) that displays the agent process tree, IPC activity, and system metrics. Like top or htop, but for agents.

Usage

Section titled “Usage”
Terminal window
actx top

What It Shows

Section titled “What It Shows”

Process Tree

Section titled “Process Tree”
  • Active agent processes and their state
  • Parent-child relationships (orchestrator → dispatched agents)
  • Process groups and their coordination status

IPC Monitor

Section titled “IPC Monitor”
  • Real-time CTX statements flowing through the gateway
  • NATS pub/sub message activity
  • Event stream subscriptions (LIVE SELECT)

System Metrics

Section titled “System Metrics”
  • Gateway throughput (ops/sec)
  • Memory plane utilization
  • Token budget consumption
  • Active backend connections

Interactive Controls

Section titled “Interactive Controls”

The TUI supports keyboard navigation:

  • Arrow keys — navigate the process tree
  • q — quit
  • r — refresh
  • f — toggle filter mode

See Also

Section titled “See Also”