Metadata-Version: 2.4
Name: claude-code-terminal
Version: 0.1.0
Summary: TUI dashboard for managing multiple Claude Code sessions via tmux
Project-URL: Homepage, https://github.com/phinease/claude-code-terminal
Project-URL: Repository, https://github.com/phinease/claude-code-terminal
Project-URL: Issues, https://github.com/phinease/claude-code-terminal/issues
Author: Phinease
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: libtmux>=0.37.0
Requires-Dist: textual>=0.85.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: textual-dev>=1.0; extra == 'dev'
Description-Content-Type: text/markdown

# 🖥️ Claude Code Terminal (CCT)

[![PyPI](https://img.shields.io/pypi/v/claude-code-terminal)](https://pypi.org/project/claude-code-terminal/)
[![Python](https://img.shields.io/pypi/pyversions/claude-code-terminal)](https://pypi.org/project/claude-code-terminal/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

> 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)

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

### Via pipx

```bash
pipx install claude-code-terminal
```

### Via pip

```bash
pip install claude-code-terminal
```

### Prerequisites

- Python >= 3.11
- tmux (`brew install tmux` / `apt install tmux`)

## 🚀 Usage

```bash
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](LICENSE)
