aimux
<sub>Tame the agent sprawl.

See all your agents. Trace what they did. Judge if it was good.</sub>

One agent just silently deleted your auth config. Another rewrote 47 files. aimux shows you exactly what happened, and lets you judge if it was good.

Quick Start

brew install zanetworker/aimux/aimux
aimux          # terminal dashboard
aimux web      # browser dashboard at localhost:9090

Requires tmux. Auto-discovers running Claude, Codex, and Gemini agents.

What It Does

See everything. Live trace of every prompt, response, and tool call as agents work. Watch file edits, bash commands, and API calls turn by turn.

Judge quality. Label turns GOOD, BAD, or WASTE. Add notes. Build eval datasets from real production sessions, not synthetic benchmarks.

Export anywhere. OTEL to MLflow or Jaeger for evaluation pipelines. JSONL to disk for offline analysis. Your annotations become feedback assessments.

Zero setup. No config, no instrumentation, no SDK. Run aimux and it finds every running agent on your machine.

Features

Discovery & Monitoring Auto-discovers Claude, Codex, and Gemini agents Live status: active, idle, waiting, error Per-agent token usage and cost tracking Model-aware pricing (Opus, Sonnet, Haiku, GPT, Gemini) Cross-session search ("which agent edited auth.go?")	Tracing & Evaluation Turn-by-turn trace of prompts, responses, tool calls Live streaming as agents work (JSONL tailing + SSE) Annotate turns as GOOD / BAD / WASTE with notes Export to MLflow, Jaeger, or any OTLP backend JSONL export with annotations for offline eval
Two Interfaces TUI: keyboard-driven, split-pane trace + live session Web: card grid, filtering, session history, trace panel Dark and light themes (web dashboard) Plugin system for custom dashboard tabs	Agent Management Launch agents in tmux (persistent) or direct mode Google Tasks integration for task-driven launches macOS notifications on permission prompts, errors, completion Session history with browse, search, and resume Kubernetes support: run agents on K8s pods

Documentation

Full documentation at zanetworker.github.io/aimux

• Getting Started - install, first run, CLI commands
• Configuration - full config.yaml reference
• Web Dashboard - cards, filters, sessions, themes
• TUI Keybindings - keyboard shortcuts
• Tracing & Annotations - trace view, OTEL, JSONL
• Launch Modes - tmux, direct, task-driven
• Adding a Provider - extend with new agents
• Kubernetes - run agents on K8s

Built With

Bubble Tea | Lip Gloss | charmbracelet/x/vt | creack/pty | OpenTelemetry | Starlight

License

MIT