About this project

ComandOS is a local-first control center for running multiple AI coding agents side by side. It targets Claude Code, OpenAI Codex CLI, Gemini CLI, OpenCode, Grok Build and Antigravity CLI, placing each in persistent tmux sessions so several agents can work in parallel. The core idea is event-driven attention: instead of scanning tabs, the system interrupts with a voice alert and an actionable popup showing the question and its real options as buttons, plus inline reply, copy and a "View ALL" view. A live dashboard at 127.0.0.1:4777 surfaces whatever is waiting for an answer. A native GTK+VTE app provides one tab per session with status dots (amber waiting, blue working, green done), Ctrl+K session jumping, splits and themes. Other features include quota/plan-usage sharing with redistribution proposals across accounts and models, copy/export of responses to clipboard, .txt or PDF, offline local voice via piper, an SSH manager over ~/.ssh/config with one-click connect and multiplexed tunnel detection, reusable shell snippets pasted with bracketed paste, and an optional Telegram bridge with reply and /ls /out /run commands. The UI is available in English and Spanish. Local-first design: runtime state lives in tmux, JSON/config files and local SQLite at ~/.claude/hooks/comandos-usage.sqlite. There is no hosted backend, external database, telemetry or SSH proxy. SSH connections go directly from the local OpenSSH client. Network features are opt-in: provider usage endpoints, Tailscale Serve for remote access, Telegram, and optional voice model download. Remote access uses cc-mobile over Tailscale Serve (never public Funnel), with automatic TLS, an access token protecting the dashboard, API and terminal attachments, a Host-header allowlist against DNS rebinding, and loopback-only binding for cc-dash and ttyd. An optional cc-webterm adds a full interactive xterm.js terminal attached to the same tmux session. Installation is via git clone and ./install.sh, requiring Linux with GNOME/X11, python3-gi, tmux and jq, with xclip, wmctrl, piper and kitty recommended. Windows 11 is supported through WSL2 + WSLg, and macOS support is described as beta with a native PyObjC/WKWebView app. The project is MIT licensed.