TUICommander

Agent Awareness

"Your agent hit a rate limit 10 minutes ago. You didn't notice."

TUICommander auto-detects what your agents are doing and alerts you when something needs attention.

Rate limit detection with provider-specific patterns and countdown timers
Question detection — Y/N prompts, numbered menus, action overlays
Usage tracking with color-coded thresholds
Activity dashboard showing all sessions at a glance

  SESSION        AGENT      STATUS
  feature/auth   Claude     Rate limited (2:41)
  main           Codex      Working...
  fix/nav        Aider      ? Confirm overwrite (Y/n)
  wip/docs       Gemini     Idle (5m)
  refactor       Amp        Working...
          

One Branch, One Worktree, One World

"One branch, git stash, pray nothing breaks. Every agent on the same copy."

Click a branch in the sidebar. TUICommander auto-creates a git worktree — a fully isolated copy of the repo. The terminal opens inside it.

One click from branch to isolated terminal session
Terminals preserved across branch switches
Every agent works on its own copy — no conflicts
Configurable base branch and setup scripts

Add repo └─ Click branch └─ Worktree auto-created ├─ Terminal opens inside │ ├─ Run Claude Code │ └─ Split → Run Aider ├─ Switch branch │ └─ Run Codex (isolated) └─ Activity dashboard shows all 3 agents

Talk to Your Agents

"Typing long prompts while reviewing code on another screen."

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

GPU-accelerated on macOS (Metal), CPU fallback elsewhere
5 model sizes from tiny (75 MB) to large-v3-turbo (1.6 GB)
Push-to-talk hotkey — text injected into active terminal
Correction dictionary for domain-specific terms

Control It from Your Mobile Device

"Agent needs a Y/N answer. You're on the couch."

TUICommander runs an HTTP server on your local network. Open the URL in any browser — phone, tablet, another laptop — and get a fully functional terminal UI.

WebSocket terminal streaming with full input support
QR code on screen for instant mobile connection
Basic Auth with bcrypt-hashed passwords
Monitor agents or approve prompts from any device
Secure tunnel with Cloudflare or Tailscale

See What Your Agents Changed

"Check the diff in VS Code. Check PR status on GitHub. Check CI in another tab."

The feedback loop happens in the same window — diffs, PR status, CI results, file navigation.

Diff panel — working tree or last 5 commits, click for inline diff
PR status badges (open/merged/draft), CI rings (green/red/yellow), review state
PR notifications — toolbar bell with rich popovers
Clickable file paths — .md opens viewer, code opens editor at correct line
Built-in CodeMirror 6 editor with syntax highlighting

  CHANGED FILES              +/-
  M src/auth/jwt.ts          +42 -18
  M src/auth/middleware.ts    +15 -3
  A src/auth/refresh.ts      +67
  D src/auth/sessions.ts     -89

  PR #247  Open  CI ●  Review: Approved
          

Documents & Code, Right Here

"READMEs, specs, changelogs scattered across the repo. Open them one by one in an editor."

Markdown viewer with tree navigation, built-in code editor, and file browser — all inside TUICommander.

Markdown panel with directory grouping and git status dots
CodeMirror 6 editor with disk conflict detection
File browser with search, rename, copy/paste, .gitignore
Clickable file paths open directly from terminal output

  docs/
    FEATURES.md           ●
    ARCHITECTURE.md
    plugins.md             ●
  src/
    README.md
  /
    CHANGELOG.md           ●
    SPEC.md
          

Extend Everything

"Want to customize your workflow? Write a VS Code extension and wait 3 days for review."

MCP HTTP server for external AI tools + Obsidian-style plugins with hot reload.

MCP server — REST, WebSocket, SSE for terminal access
Plugin system with 4 capability tiers and hot reload
Terminal output watchers with regex triggers
Status bar tickers, notification contributions, markdown panels
Community registry — browse and install with one click

// my-plugin/index.js
export function activate(host) {
  host.registerWatcher({
    pattern: /error|fail/i,
    onMatch(line) {
      host.notify("Build failed!");
    }
  });

  host.addTicker({
    label: "My Status",
    render: () => "OK"
  });
}
          

Claude Usage Dashboard

"You burned through 80% of your Claude weekly limit and didn't know until it stopped responding."

Real-time usage tracking with heatmaps, rate limit bars, and per-project insights — always visible in the status bar.

Color-coded thresholds — green, yellow, red
Session vs weekly limit tracking
Heatmap of usage across hours and days
Auto-refreshes from the Claude usage API

  CLAUDE USAGE
  Weekly:  ████████████░░░░  72%
  Session: ████░░░░░░░░░░░░  23%

  HEATMAP (this week)
  Mon  ▁▂▃▅▇█▅▃▁
  Tue  ▁▃▅▇█▇▅▃▂
  Wed  ▁▂▅▇████▇▅
  Thu  ▁▁▂▃▃▂▁  ← today
          

Prompt Library & Run Commands

"Typing the same 200-word prompt for the fifth time today. Copy-paste from a text file."

Saved prompts with variable substitution. Press Cmd+K to pick a template and inject it into the active terminal.

Templates with {{diff}}, {{branch}}, {{cwd}}, and custom variables
Per-repo saved run commands (Cmd+R)
Inject directly into the focused terminal session
Manage and edit from the prompt library panel

  PROMPT LIBRARY
  Code Review
  Review {{diff}} for bugs, security
  issues, and style violations.
  Focus on the {{branch}} changes.

  Explain
  Explain what this code does:
  {{selection}}

  Test Writer
  Write tests for {{file}} covering
  edge cases and error paths.
          

Detachable Tabs & Split Panes

"One monitor, one window, alt-tabbing between 6 terminal sessions."

Float any terminal into its own OS window. Split vertically or horizontally. Drag to reorder. Multi-monitor native.

Detach any tab into a floating OS window
Re-attaches automatically on close
Vertical and horizontal splits with drag-resize
Drag tabs to reorder, double-click to rename

┌─────────────────────────┐ │ TUICommander │ │ ┌──────┬──────────┐ │ │ │ Tab1 │ Tab2 │ │ │ ├──────┴──────────┤ │ │ │ $ claude code │ │ │ │ > Working... │ │ │ ├─────────────────┤ │ │ │ $ aider │ │ │ │ > Ready │ │ │ └─────────────────┘ │ └─────────────────────────┘ ↕ detach ┌───────────────┐ │ Floating Tab3 │ │ $ codex │ │ > Reviewing...| └───────────────┘

Why TUICommander

Pain point	TUICommander	tmux / terminal tabs	VS Code
Agent hits rate limit silently	Auto-detects, countdown timer	You don't know	No detection
Agent asks a question and stalls	Tab indicator, notification, overlay	Silent stall	Silent stall
Isolated workspace per agent	Auto-created git worktree	Manual git worktree add	Manual
See what agents changed	Inline diff, PR status, CI rings	Switch tool	Built-in, agents external
Running 5+ agents on same project	Sidebar, splits, activity dashboard	Pane hell	Tab hell
Dictate prompts to agents	Built-in local Whisper	Not possible	Extension required
Monitor from another device	Built-in browser UI, QR code	SSH + tmux attach	Not possible
External AI tools need access	MCP server, HTTP/WS/SSE	Not possible	Limited extensions

And a Full-Featured Terminal

Everything you'd expect from a modern terminal, plus a few extras.

50 sessions with independent zoom (8–32px)

Find in terminal — regex, case-sensitive, match nav

Session persistence — survives restarts

Lazygit inline, split pane, or floating

Repository groups — named, colored, collapsible

IDE launchers — VS Code, Cursor, Zed, Xcode

Command palette — fuzzy search all actions

International keyboard support

13 bundled fonts — JetBrains Mono, Fira Code, and more

Frequently Asked Questions

Is it free?

Yes. TUICommander is MIT licensed and free to use.

Does it work on Windows and Linux?

Yes. TUICommander is cross-platform — macOS, Windows, and Linux. macOS builds are signed and notarized.

Do I need a GitHub token?

Optional. A GitHub token enables PR status badges, CI rings, and PR notifications. Without it, you still get the full terminal experience.

Can I use it without AI agents?

Yes. TUICommander is a fully featured terminal manager with git integration, split panes, and 50 sessions. Agent monitoring is a bonus, not a requirement.

How does voice dictation work?

It uses whisper-rs, a local implementation of OpenAI's Whisper model. Everything runs on your machine — GPU-accelerated on macOS via Metal, CPU on other platforms. No cloud, no API keys, no data transmitted.

What's the MCP server?

TUICommander exposes a Model Context Protocol server on localhost. External AI tools like Claude Code, Cursor, and others can read terminal output, send commands, and check status through REST, WebSocket, and SSE endpoints.

Can I write plugins?

Yes. TUICommander has an Obsidian-style plugin system with hot reload, 4 capability tiers, terminal output watchers, and a community registry. See the Plugin Authoring Guide.

How do worktrees work?

When you click a branch in the sidebar, TUICommander creates a git worktree — a separate checkout of the same repo with its own working directory. Each branch gets its own isolated copy. Terminals are preserved when you switch branches and restored when you switch back.

Does it support my terminal theme?

TUICommander includes multiple built-in themes and supports custom color schemes in Settings. Font size is configurable per-session from 8px to 32px.

Is my data sent anywhere?

No. TUICommander has zero telemetry. Everything runs locally. The only network calls are to GitHub's API (if you provide a token) and optionally to the plugin registry.

Auto-detects and monitors 11 AI coding agents