Skip to content

sstraus/tuicommander

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3,020 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

TUICommander

TUICommander

The IDE that understands AI agents.
Run parallel agents on isolated branches with full observability.

Release Nightly CI License Platform Rust Tauri v2 Dependency Audit Stars

Website β€’ Download β€’ Nightly β€’ All Features β€’ Plugin API β€’ Docs


TUICommander β€” multiple agents, split panes, sidebar with repos


The problem

You're running Claude Code in one terminal, Aider in another, Codex in a third. One hit a rate limit 10 minutes ago and you didn't notice. Another is waiting for a Y/N confirmation. You switch between windows and still lose track.

The more sessions you run, the worse it gets. The tooling doesn't understand what's happening inside the terminal.

The solution

TUICommander is an AI-native IDE β€” designed from the ground up for multi-agent development. Agents, code, diffs, PRs, CI status, and usage analytics live in one window. No context switching. No lost threads.

AI-native means the agents are not an afterthought. Rate limit detection, question recognition, session-aware resume, and usage tracking are core β€” not plugins.


What makes it different

Run many AI sessions in parallel

Launch Claude Code on five branches at once β€” or mix agents. Each session runs in its own Git worktree β€” no context collision, no stash conflicts, no "which terminal was that?" moments.

  • Up to 50 terminal sessions running simultaneously
  • Each session works on its own isolated copy of the repo
  • Activity dashboard showing every session at a glance

Agent observability β€” not just terminals

TUICommander auto-detects 10 AI coding agents (Claude Code, Codex CLI, Aider, Gemini CLI, Amp, Cursor Agent, OpenCode, Warp Oz, Droid, Goose) and understands what they're doing:

  • Rate limit detection β€” Provider-specific patterns with countdown timers per session.
  • Question detection β€” Y/N prompts, numbered options, inquirer-style menus. Tab indicator, notification sound, keyboard overlay.
  • Usage tracking β€” Claude Code weekly/session limits with color-coded thresholds. Full Claude Usage Dashboard with rate limit bars, 7-day chart, 52-week heatmap, per-project breakdown.
  • Activity dashboard β€” Every session at a glance: agent type, status (working / waiting / rate-limited / idle), last activity.
  • Session-aware resume β€” Auto-discovers agent session IDs from disk (Claude Code, Gemini CLI, Codex CLI). Resume exactly where you left off.

No other tool knows that your agent is stuck.

Git worktrees, fully managed

Click a branch in the sidebar. TUICommander auto-creates a git worktree β€” a fully isolated copy of the repo. The terminal opens inside it. Switch to another branch: your previous terminals are preserved. Switch back: they're exactly as you left them.

  • Automatic worktree creation on branch click
  • Worktree Manager β€” PR status, dirty file counts, last commit at a glance
  • Post-merge cleanup dialog β€” delete branch, archive worktree in one click
  • Configurable base branch, setup scripts, auto-fetch intervals

See what your agents changed β€” without leaving

The feedback loop happens in the same window:

  • Git Panel β€” Staging, inline commit, blame with age heatmap, canvas commit graph, stashes, branches with ahead/behind counts.
  • Diff views β€” Side-by-side, unified, or scroll-all-files. Word-level highlighting, hunk and line-level restore.
  • PR management β€” Merge via GitHub API with auto-detected merge method. Post-merge cleanup.
  • GitHub Issues β€” Filter by assigned/created/mentioned, labels with colors, close/reopen.
  • CI Auto-Heal β€” When CI fails, TUICommander fetches failure logs and injects them into the agent for automatic fix.
  • Built-in code editor β€” CodeMirror 6 with syntax highlighting, find/replace, disk conflict detection.
  • File browser β€” Directory tree, content search (grep), git status indicators.

Built-in AI Chat & autonomous agent

A conversational AI companion that sees your terminal as you see it. Ask about errors, get code suggestions, or let the autonomous agent take the wheel and drive your terminal directly.

  • Multi-provider: Ollama (local, free), Anthropic, OpenAI, OpenRouter, or any compatible endpoint
  • Autonomous AI Agent (ReAct loop) with 12 tools: read screen, send input, edit files, search code, run commands
  • Session knowledge: the agent learns from your terminal history β€” commands, errors, fix patterns
  • Live cost tracking: prompt/completion tokens and estimated cost per turn
  • Per-terminal chat state, conversation history, detachable panel for multi-monitor

MCP Proxy Hub β€” one connection for all your tools

Aggregate all your MCP servers into a single endpoint. Claude Code, Cursor, VS Code β€” each agent connects once and gets access to every upstream tool.

  • Auto-configures Claude Code, Cursor, Windsurf, VS Code, Zed, Amp, Gemini
  • Circuit breakers, health checks, hot-reload per upstream
  • Credential management via OS keyring, OAuth 2.1 support
  • Tool filtering: whitelist or blacklist per upstream server

Control from anywhere

A mobile companion PWA lets you monitor agents from your phone, answer questions with one tap, and track rate limits in real time.

  • QR code scan for instant LAN connection
  • Tailscale auto-HTTPS or E2E-encrypted cloud relay β€” no VPN or port forwarding
  • Live WebSocket output, suggest follow-up chips, slash menu

Agents that coordinate

Agent Teams β€” Claude Code's sub-agents run as native TUICommander tabs instead of tmux panes. Full session awareness, output parsing, and question detection for each sub-agent.

Inter-agent messaging β€” When multiple agents work in parallel, they discover peers, send messages, and receive push notifications through TUICommander as the coordination hub.

Automate repetitive workflows

30 built-in Smart Prompts turn common tasks into one-click operations: Smart Commit, Review Changes, Create PR, Fix CI, and more. Context variables like branch, diff, and PR data are resolved automatically.

  • Inject mode (PTY write), headless mode (subprocess), or shell script mode (direct execution)
  • 31 context variables auto-resolved from git, GitHub, and terminal state
  • Create your own prompts with the same variable system

Talk to your agents

On-device speech-to-text powered by whisper-rs. No cloud service, no API keys, no data leaving your machine.

  • GPU-accelerated on macOS (Metal), CPU fallback on Windows/Linux
  • Push-to-talk hotkey β€” text injected into the active terminal
  • 5 model sizes from tiny (75 MB) to large-v3-turbo (1.6 GB)

Extend everything

Plugin system β€” Obsidian-style plugins with hot reload and a community registry:

  • 5 capability tiers from read-only watchers to scoped Tauri invoke
  • TUIC SDK v1.0: tuic.activeRepo, tuic.toast, tuic.onRepoChange and more
  • Terminal output watchers with regex triggers
  • Status bar tickers, custom panels, notification contributions
  • Browse and install with one click

Plugin Authoring Guide β†’


How it compares

Capability Ghostty / Kitty Warp Cursor IDE Claude Desktop TUICommander
Terminal sessions Yes Yes Yes No Yes (50)
AI coding agents No Partial Built-in Built-in Any agent (10 detected)
Parallel agents No No Limited No Unlimited
Git worktree orchestration No No No No Automatic
Agent observability No No No No Real-time
Global Workspace No No Yes No Multi-repo
Usage dashboard No No No Basic Full (heatmap, per-project)
Remote access (phone/tablet) No No No Mobile app PWA + E2E relay
Voice dictation No No Extension Built-in Local Whisper
MCP Proxy Hub No No No No Built-in
Plugin system No No Extensions No Hot reload + SDK
GitHub Issues & PR management No No Extension No Built-in
Built-in AI Chat No Built-in Built-in Built-in Multi-provider (beta)
CI Auto-Heal No No No No Built-in

Terminal features β€” 50 sessions, splits, detach, find, persistence
  • Up to 50 concurrent PTY sessions, each with independent zoom (8–32px)
  • Split panes: vertical (Cmd+\) or horizontal (Cmd+Alt+\), up to 6 panes, drag-resize
  • Detachable tabs: float any terminal into its own OS window, re-attaches on close
  • Find in terminal (Cmd+F): regex, case-sensitive, whole word, match navigation
  • Cross-terminal search: type ~ in command palette to search all open terminal buffers
  • Session persistence: terminals survive restarts with lazy restore on branch click
  • Tab management: reorder by drag, rename by double-click, reopen last 10 closed tabs
  • Tab status dots: idle, busy, done, unseen, question, error
  • Copy on select, configurable bell (visual/sound/both), scroll shortcuts
  • International keyboard support, Kitty keyboard protocol
  • 11 bundled monospace fonts (JetBrains Mono, Fira Code, Hack, Cascadia Code, and more)
Git integration β€” Worktrees, Git Panel, PR management
  • Auto-create worktrees per branch with configurable base branch and setup scripts
  • Worktree Manager (Cmd+Shift+W): all worktrees across all repos, orphan detection, batch operations
  • Git Panel (Cmd+Shift+D): staging, commit, log with canvas commit graph, stashes, branches, blame with age heatmap
  • PR management: merge via GitHub API, auto-detect merge method, post-merge cleanup dialog
  • GitHub Issues: filter by assigned/created/mentioned, labels with colors, close/reopen
  • Auto-delete branch on PR close, CI Auto-Heal, PR notifications
  • Repository groups: named, colored, collapsible, drag-and-drop reordering
  • Park repos: temporarily hide repos you're not using
  • Quick branch switcher: hold Cmd+Ctrl, press 1-9 to switch instantly
  • Auto-fetch on configurable interval
Productivity β€” Smart Prompts, palette, keybindings, dictation
  • Smart Prompts (Cmd+Shift+K): 30 built-in AI automation prompts with auto-resolved context variables
  • Command palette (Cmd+P): fuzzy search all actions, files (!), file contents (?), terminal buffers (~)
  • Configurable keybindings with chord support and conflict detection
  • Claude Usage Dashboard: rate limits, 7-day chart, 52-week heatmap, per-project breakdown
  • Prompt library (Cmd+K): saved prompts with variable substitution
  • IDE launchers: open in VS Code, Cursor, Zed, or any detected editor
  • Ideas panel (Cmd+Alt+N): quick notes with image paste and send-to-terminal
  • Voice dictation: streaming on-device Whisper with partial results
  • Focus mode (Cmd+Alt+Enter): maximize active tab, hide sidebar and panels

Full feature reference: docs/FEATURES.md


Get started

Download the latest release β€” macOS builds are signed and notarized.

Install via terminal:

# macOS (Homebrew)
brew install sstraus/tap/tuicommander

# macOS / Linux (shell)
curl -fsSL https://tuicommander.com/install.sh | sh

# Windows (PowerShell)
irm https://tuicommander.com/install.ps1 | iex

Want the bleeding edge? The Nightly is rebuilt on every push to main.

Build from source

Prerequisites: Node.js 22+, Rust toolchain, Tauri CLI

npm install
npm run tauri dev      # Development with hot reload
npm run tauri build    # Production build
npm test               # Run tests

See docs/guides/development-setup.md for platform-specific instructions.

Built with

Rust + Tauri v2 backend, SolidJS UI, native terminal via alacritty_terminal + canvas rendering, CodeMirror 6 editor, whisper-rs dictation, Vite + LightningCSS build. ~80 MB RAM.

Documentation

Getting Started First-run guide
Features Complete feature reference with all keyboard shortcuts
AI Agents Agent detection, rate limits, question detection
Plugin API Build plugins for TUICommander
HTTP API REST/WebSocket/SSE endpoints
Architecture System design and component overview
Development Setup Build from source

Apache 2.0 licensed. Zero telemetry. Runs locally.
Follow the releases β€” new features land weekly.

License

Apache 2.0 Β© 2026 Stefano Straus

About

Desktop terminal orchestrator for running dozens of AI coding agents in parallel. Tauri + SolidJS + Rust.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors