Skip to main content

​
Install

Termix works on macOS and Windows. You need Node.js installed. 
npm install -g termix-cli
Then run it with: 
termix
Or run directly without installing: 
npx termix-cli
Open http://localhost:4000 in your browser. That’s it — you’re in.

​
Your First Session

1

Click the + button

In the sidebar, click the + button to open the session launcher.
2

Pick an agent

You’ll see buttons for each installed agent (Claude Code, Codex, Gemini CLI, OpenCode) plus a Shell option. Click the one you want.
3

Start working

A new terminal session opens. Use the agent exactly as you normally would — type prompts, run commands, everything works the same.
The sidebar now shows your session with a live status indicator and message preview. Launch more sessions to see Termix shine — you’ll be able to track all of them at a glance.

​
Set Up Telemetry

Telemetry is what gives Termix its intelligence — knowing when agents are working, idle, or finished. Without it, Termix is just a terminal multiplexer.
Nothing to do. Claude Code telemetry is enabled automatically when launched from Termix. It just works.

​
What You’ll See

Once telemetry is connected, the sidebar comes alive:
  • Green bouncing dot — The agent is actively working (generating code, running tools)
  • “zzZ” indicator — The agent is idle, waiting for your input
  • Preview text — The last meaningful line the agent output, right in the sidebar
  • Unread dot — New output you haven’t looked at yet

​
Next Steps

Agent guides

Detailed setup for each supported agent.

Sessions

Resume, restart, rename, and organize your sessions.

Projects

Group sessions by project with drag-and-drop.

Notifications

Get notified when agents finish working.