claude-code-terminal 0.1.0

TUI dashboard for managing multiple Claude Code sessions via tmux

🖥️ Claude Code Terminal (CCT)

TUI dashboard for managing multiple Claude Code sessions via tmux.

✨ Features

• 🔐 In-dashboard permission handling — Approve/deny permission requests directly from the dashboard, no need to attach to tmux
• ⌨️ Vim-style modal operation — Normal mode for session management, Interactive mode for direct Claude Code interaction
• 🔄 4-state detection — Real-time identification of Working / Idle / Waiting / Stopped states
• 🖼️ Live preview — Capture pane output with full ANSI color rendering
• 🎯 WAITING auto-focus — Automatically switches to sessions awaiting permission, with FIFO queue processing
• 🤖 Auto Pilot — Per-session toggle to auto-approve permission requests
• 🔔 macOS notifications — Push notifications for permission requests and task completion
• 🧩 Plugin architecture — Extensible to support Codex, Aider, and other AI coding tools

📦 Installation

Quick Install (recommended)

curl -fsSL https://raw.githubusercontent.com/phinease/claude-code-terminal/main/install.sh | sh

Via pipx

pipx install claude-code-terminal

Via pip

pip install claude-code-terminal

Prerequisites

• Python >= 3.11
• tmux (brew install tmux / apt install tmux)

🚀 Usage

cct

⌨️ Keybindings

Normal Mode

Key	Action
↑ / ↓	Navigate sessions
n	New session
r	Rename session
i	Enter Interactive mode
a / d	Approve / Deny permission request
1-9	Select numbered permission option
p	Toggle Auto Pilot
c	Select mode (text copy)
Ctrl+\	Toggle session panel
Ctrl+x	Delete session
q	Quit

Interactive Mode

All keystrokes pass through directly to Claude Code.

Key	Action
Ctrl-]	Exit to Normal mode
Ctrl+\	Toggle session panel
Shift+Enter	Newline (kitty protocol terminals)
Alt+Enter	Newline (legacy terminals)
Mouse click on session list	Switch session

🖼️ Interface

+----------------------------------------------------------------+
| Vibe · Agent Dashboard                                         |
+----------------------------------------------------------------+
| Sessions           | Preview: frontend-refactor (claude)        |
|--------------------|---------------------------------------------|
| * frontend-refactor| > Analyzing src/components/Header.tsx...    |
|   proj/frontend    |                                             |
| * api-fix          |   I'll update the Header component to       |
|   proj/backend     |   use the new theme variables.              |
| ! test-fix         |---------------------------------------------|
|   proj/tests       | ! Permission: execute `npm test`            |
| o data-migration   |   [a:Allow] [d:Deny]                        |
|   proj/migration   |                                             |
+--------------------+---------------------------------------------+
| NORMAL — i:Interactive  n:New  a/d:Allow/Deny  p:Pilot         |
+----------------------------------------------------------------+

Status icons: * Working  ! Waiting  o Idle  x Stopped

🗺️ Roadmap

Version	Goal
v0.1 (current)	MVP — Session management, preview, permission handling, Vim modal, notifications
v0.2	Multi-tool support (Codex/Aider), session groups, fuzzy search
v0.3	Web version (textual-web), diff view, Docker isolation

📄 License

MIT