aimux
Multiplex your AI agents. Trace, launch, export. Never leave the terminal.
You're running 5 agents across 3 projects. Claude is refactoring auth. Codex is writing tests. A third session is idle, or stuck on a permission prompt? You don't know, because each lives in its own terminal.
aimux is your control plane. One terminal. Every agent. Full visibility.
- See everything: all agents, their status, model, cost, and project in one view
- Trace what happened: every prompt, response, and tool call, turn by turn
- Launch from here: spawn Claude, Codex, or Gemini without leaving the terminal
- Annotate, label, and export: mark turns GOOD/BAD/WASTE, export to MLflow for eval datasets
- Bring your own agent: pluggable provider interface, add a new agent in one Go file
┌───────────────────────────────────────────────────────────────────────────────┐
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ aimux │
│ │ ● Active 2 │ │ ◐ Waiting 0 │ │ ○ Idle 1 │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ Agents │
├────────────────────────────────┬──────────────────────────────────────────────┤
│ NAME AGENT MODEL │ ● claudetopus │
│───────────────────────────────│ claude · opus-4.6 · dangerously │
│▸● claudetopus claude opus-4.6│──────────────────────────────────────────────│
│ dangerously · 14m · $0.82 │ 14:32 USER fix the auth bug in login.go │
│ │ 14:32 ASST I'll redesign the header... │
│ ● trustyai claude sonnet │ 14:33 TOOL Edit styles.go │
│ plan · 8m · $0.31 │ 14:33 ASST Updated. Build succeeded. │
│ │ │
│ ○ llama-stack claude haiku │ [12/12] ● │
│ default · 2h · $0.11 │ │
├────────────────────────────────┴──────────────────────────────────────────────┤
│ :cmd j/k:nav Enter:zoom l:trace /:filter ?:help │
└───────────────────────────────────────────────────────────────────────────────┘
Quick Start
git clone https://github.com/zanetworker/aimux.git
cd aimux
make install # builds and copies to /usr/local/bin
aimux # launch the TUI
Requires Go 1.24+ and tmux for split-pane session embedding.
Features
Discovery
Auto-finds running Claude, Codex, and Gemini processes. Shows status, model, tokens, cost, git branch, and permission mode. Refreshes every 2s.
Split View
Press Enter on any agent to open trace + session side by side. Live trace on the left, interactive session on the right. Claude uses direct PTY embedding, Codex and Gemini use tmux mirror.
Conversation Trace
Full turn-by-turn view of prompts, responses, and tool calls:
17:32 USER fix the authentication bug in login.go
17:32 ASST I'll look at the login.go file...
17:32 TOOL Read /src/auth/login.go
17:32 TOOL Edit /src/auth/login.go [BAD] "deleted wrong file"
Annotations
Label turns as GOOD, BAD, or WASTE while watching agents work. Add free-text notes. Annotations persist to disk and export with traces.
Export to MLflow
Press e in the trace pane to export:
j JSONL to ~/.aimux/exports/
o OTLP to MLflow, Jaeger, or any OTEL backend
Annotations become MLflow feedback assessments for building eval datasets.
Agent Launcher
Press :new to spawn agents. Pick provider, model, mode, and project directory. Launches into tmux with OTEL telemetry enabled.
Cost Dashboard
Aggregated token usage and estimated USD spend per project:
PROJECT AGENT MODEL IN OUT COST
claudetopus claude opus-4.6 128.0K 22.0K $3.57
trustyai claude sonnet 45.0K 8.0K $1.28
─────────────────────────────────────────────────────────
TOTAL 173.0K 30.0K $4.85
OTEL Receiver
Built-in OTLP/HTTP receiver on port 4318 collects live telemetry from spawned agents. Debug anytime: curl http://localhost:4318/debug
Teams
View Claude Code team configurations and members.
Key Bindings
| Key |
Where |
Action |
j/k |
Everywhere |
Navigate up/down |
Enter |
Agent list |
Split view (trace + session) |
l |
Agent list |
Standalone trace view |
Tab |
Split view |
Switch focus between panes |
e |
Trace pane |
Export menu (j:JSONL, o:OTEL) |
a |
Trace pane |
Annotate turn (GOOD/BAD/WASTE) |
N |
Trace pane |
Add note to annotated turn |
Ctrl+f |
Split view |
Toggle fullscreen on focused pane |
x |
Agent list |
Kill agent |
:new |
Anywhere |
Launch new agent |
Esc |
Split/trace |
Exit to agent list |
? |
Anywhere |
Help |
Configuration
~/.aimux/config.yaml, all settings optional:
providers:
claude:
enabled: true
codex:
enabled: true
gemini:
enabled: false
shell: /bin/zsh
# OTEL receiver: collects live telemetry from spawned agents
otel:
enabled: true
port: 4318
# OTLP export: where to send traces (e → o in trace pane)
export:
endpoint: "localhost:5001"
insecure: true
mlflow:
experiment_id: "1" # required by MLflow
MLflow setup
# Start MLflow
mlflow server --host 127.0.0.1 --port 5001
# Create an experiment
curl -X POST http://localhost:5001/api/2.0/mlflow/experiments/create \
-H "Content-Type: application/json" \
-d '{"name": "agent-evals"}'
# Returns {"experiment_id": "1"} — put in config above
In aimux: Tab to trace pane, a to annotate, e then o to export.
Provider System
| Provider |
Discovery |
Trace |
Session |
OTEL |
| Claude |
Process scan + JSONL |
Full conversations |
Direct PTY embed |
Logs via http/protobuf |
| Codex |
Process scan + JSONL |
Full conversations |
Tmux mirror |
Traces + logs |
| Gemini |
Process scan + JSON |
User prompts |
Tmux mirror |
Traces + logs |
Adding a new provider
Implement the Provider interface (10 methods), register in app.go, add pricing:
type Provider interface {
Name() string
Discover() ([]agent.Agent, error)
ResumeCommand(a agent.Agent) *exec.Cmd
CanEmbed() bool
FindSessionFile(a agent.Agent) string
RecentDirs(max int) []RecentDir
SpawnCommand(dir, model, mode string) *exec.Cmd
SpawnArgs() SpawnArgs
ParseTrace(filePath string) ([]trace.Turn, error)
OTELEnv(endpoint string) string
}
See Adding a Provider for the full walkthrough.
Architecture
No daemon, no hooks, no modifications to your AI tools. Reads from the filesystem:
| Source |
Location |
Data |
| Config |
~/.aimux/config.yaml |
Provider settings, export config |
| Process table |
ps aux |
Running agents |
| Session logs |
~/.claude/projects/*/, ~/.codex/sessions/ |
Conversations, tool calls |
| OTEL receiver |
localhost:4318 |
Live telemetry from agents |
| Teams |
~/.claude/teams/*/config.json |
Team membership |
Built With
Bubble Tea |
Lip Gloss |
charmbracelet/x/vt |
creack/pty |
OpenTelemetry
License
MIT