aimux

module
v0.9.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 10, 2026 License: MIT

README

aimux logo
aimux
Tame the agent sprawl.

See all your agents. Trace what they did. Judge if it was good.

Release License Docs

aimux demo

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

Trace with annotations Cost tracking

Documentation

Full documentation at zanetworker.github.io/aimux

Built With

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

License

MIT

Directories

Path Synopsis
cmd
aimux command
mcp command
internal
clipboard
Package clipboard provides cross-platform text clipboard operations.
Package clipboard provides cross-platform text clipboard operations.
controller
Package controller provides UI-agnostic business logic for aimux.
Package controller provides UI-agnostic business logic for aimux.
history
Package history discovers and manages past AI agent sessions.
Package history discovers and manages past AI agent sessions.
task
Package task defines the unified Task model and loaders for both Redis (K8s agents) and local filesystem (Claude Code teams).
Package task defines the unified Task model and loaders for both Redis (K8s agents) and local filesystem (Claude Code teams).
trace
Package trace defines shared types for conversation trace parsing.
Package trace defines shared types for conversation trace parsing.
pkg
rediskeys
Package rediskeys defines all Redis key patterns for the k8s-agents system.
Package rediskeys defines all Redis key patterns for the k8s-agents system.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL