ComandOS

Mission control for running many Claude Code agents in parallel — it tells you who needs you.
Offline voice alerts, actionable popups with full rendered markdown, tabbed terminals,
and Telegram remote control. You answer with one keystroke and move on.

Léeme en español →

Why

When you run 10 Claude Codes at once, the problem isn't terminals — it's knowing
which one needs you and getting back to it without friction. ComandOS turns that
into an event-driven flow: the system interrupts you (voice + actionable popup),
you answer with a key or a line, and you keep going. No tab-scanning.

What you get

• Live dashboard (127.0.0.1:4777): whatever waits for YOUR answer shows up big,
  with the question's real options as buttons. Respond without switching windows.
• Actionable popups: full text with rendered markdown (tables included),
  1/2/3 buttons, inline reply, Copy, and "View ALL". Never answer blind.
• Native app (GTK + VTE): one tab per session with a status dot
  (amber = waiting · blue = working · green = done), Ctrl+K jumps to any session,
  renameable tabs, splits, and Night/Day/Warm themes.
• Copy & export any response: clipboard, .txt, or PDF with rendered markdown —
  from the terminal, the popup, or the dashboard.
• Local voice (piper, 100% offline) + chime, one global volume that everything respects.
• SSH manager: CRUD over ~/.ssh/config, one-click connect, detects live
  multiplexed tunnels (no-password reconnect).
• Telegram: buttons on notifications, reply to answer, /ls /out /run.
• Everything is files (tmux, JSON, ssh config). No cloud, no DB. Survives reboots.
• UI in English and Spanish (auto-detected from $LANG, switchable in Settings).

Install

git clone https://github.com/0xAI-Builders/comandos.git
cd comandos && ./install.sh

Requires Linux with GNOME/X11, python3-gi, tmux, jq.
Recommended: xclip, wmctrl, piper (voice), kitty.
Open ComandOS from your app menu, or the dashboard at http://127.0.0.1:4777.

Agents

One command connects everything you have installed: cc-agents setup.
If Codex asks you to review new hooks, open /hooks in Codex and trust the
ComandOS hook once.
Any other agent can join with a single HTTP call:
POST 127.0.0.1:4777/event {"agent","event","cwd","msg?","full?"}.

Phone & tablet (secure)

Keep prompting from your phone — securely, in one command:

cc-mobile          # connects over your tailnet and shows a QR to pair

Scan the QR, open the dashboard, "Add to Home Screen" — it installs as an app
(PWA), no App Store. Answer prompts, reply to agents, run sessions from bed.

Want the FULL interactive terminal on your phone? Install ttyd and run
cc-webterm — every session gets a Terminal button that opens the real,
live, interactive terminal (xterm.js attached to the same tmux session). Type,
scroll, run vim — exactly like sitting at your desk, shared in real time.
Routed under /term by the same Tailscale Serve, behind the same token.

Security is layered, on by default:

• Tailscale (WireGuard): only your devices, end-to-end encrypted. Never on the public internet — Serve only, never Funnel.
• Automatic TLS via tailscale serve (https on your tailnet).
• Access token: even inside your tailnet, no token → no access. cc-dash still binds only to 127.0.0.1; Serve bridges it.
• Anti-DNS-rebinding: Host-header allowlist (loopback + *.ts.net).
• Local desktop app/browser needs no token; only remote/proxied requests do.

cc-mobile off stops exposing it.

Platforms

Pieces

Roadmap

Support for more agents is planned — see
Codex CLI and
Antigravity. PRs welcome.

Support

If it saves you time, buy me a coffee — it keeps the project alive:
Buy Me a Coffee ·
GitHub Sponsors

License

MIT