0xjesus/comandos

Run Claude Code, OpenAI Codex CLI, Gemini CLI, OpenCode, and other coding
agents side by side in persistent tmux terminals. Get actionable
notifications, manage direct SSH sessions, monitor plan usage, and continue
securely from your desktop, phone, or tablet through the remote terminal
PWA over Tailscale — without a hosted ComandOS backend, external ComandOS
database, telemetry, or SSH proxy.
**Léeme en español →**
Why
When you run many coding agents at once, the problem isn't terminals — it's
**knowing which one needs you and getting back to it without friction**.
ComandOS turns Claude Code, Codex CLI, Gemini CLI, OpenCode, and regular shell
sessions 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.
Local-first by design
ComandOS runs on your computer. Runtime state lives in local tmux sessions,
JSON and configuration files, and local SQLite at
~/.claude/hooks/comandos-usage.sqlite. There is no hosted ComandOS backend,
external ComandOS database, telemetry service, or ComandOS SSH proxy.
SSH hosts are read from ~/.ssh/config, and the installed OpenSSH client
connects directly from your computer to the selected server. ComandOS does not
upload your SSH configuration or private keys to a ComandOS service. If you
explicitly request passwordless setup, ssh-copy-id copies only the selected
public key to that server.
Some features cross the network only when you use or configure them:
- Agent CLIs communicate with their own AI providers under those providers'
terms and settings.
- Plan-usage monitoring may query Anthropic or OpenAI usage endpoints directly
when matching credentials are configured.
- Remote access through Tailscale Serve is optional and stays inside the
tailnet configuration you control.
- ComandOS no longer includes a Telegram bot: notifications do not pass
through the Telegram Bot API. Upgrading keeps any old telegram.env on disk
untouched; delete it yourself if you no longer need it.
- Voice playback is local after installation; cc-doctor --fix may download
an optional Piper voice model when you ask it to repair voice support.
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.
- **Quota sharing** (Analytics → Reparto): each plan is a tank showing what you have
spent and what your live sessions will add before it renews, with "reaches the reset"
or "runs out in 1d 22h" instead of a bare percentage. One click proposes a
redistribution across accounts, motors, models and efforts; drag a session to another
tank to overrule it; apply restarts them keeping the conversation, with per-session
progress and revert.
- **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).
- **Snippets**: save reusable shell commands (one-liners or multi-line scripts) and paste them into the active session with **Ctrl+Shift+K**. Bracketed paste — nothing runs until you press Enter.