cc-tmux-stream

Stream tmux pane contents to a Firefox sidebar with full input support. Monitor and control Claude Code sessions or other terminal applications while browsing.

Features

• Real-time streaming of tmux pane content (~150ms refresh)
• ANSI color support (256-color and true color)
• 500 lines of scrollback history
• Input controls: quick buttons (1-5, Y/N), navigation (arrows, Tab, Space, Enter), control keys (Ctrl-O, Ctrl-C, Ctrl-L), and text input
• Token-based authentication
• Auto-discovery of all tmux sessions/windows/panes
• Smart scroll: auto-follows output, preserves position when reviewing history

Quick Start

1. Build and run the daemon

cd daemon
cargo build --release
./target/release/tmux-stream

On first run, a config file is created at ~/.config/tmux-stream/config.toml with a generated auth token. The token is displayed on startup - copy it for the extension.

2. Install the Firefox extension

Option A: Signed extension (recommended)

1. Download cc-tmux-stream-0.1.1-signed.xpi from Releases
2. Open Firefox → File → Open File → select the .xpi
3. Click "Add" when prompted

Option B: Development (temporary)

1. Open about:debugging#/runtime/this-firefox
2. Click "Load Temporary Add-on..."
3. Select extension/manifest.json

3. Configure the extension

1. Right-click the tmux-stream icon → Options
2. Paste the token from the daemon output
3. Save

4. Use the sidebar

1. View → Sidebar → tmux Stream (or click the extension icon)
2. Click "Connect"
3. Select a tmux pane from the dropdown
4. Use the input buttons to interact with the terminal

Input Controls

Button	Action
1-5	Send number key (for Claude prompts)
Y / N	Send y/n response
↑ ↓ ← →	Arrow key navigation
⇥	Tab key
␣	Space (toggle options)
^O	Ctrl-O (toggle output view in Claude Code)
^C	Ctrl-C (send interrupt signal)
^L	Ctrl-L (clear screen)
⏎	Enter key
Text + Send	Send custom text with Enter

Configuration

The daemon config file (~/.config/tmux-stream/config.toml):

[server]
host = "127.0.0.1"
port = 19475

[auth]
token = "your-generated-token"

[capture]
interval_ms = 150

Project Structure

├── daemon/                 # Rust WebSocket server (tokio/axum)
│   └── src/
│       ├── main.rs         # Entry point
│       ├── config.rs       # Config file handling
│       ├── protocol.rs     # WebSocket message types
│       ├── server.rs       # WebSocket server
│       └── tmux.rs         # tmux integration
│
├── extension/              # Firefox extension (Manifest V2)
│   ├── sidebar/            # Main sidebar panel
│   ├── options/            # Settings page
│   └── icons/
│
└── docs/                   # Documentation & assets

Requirements

• Rust 1.70+
• Firefox 109+
• tmux running in the same environment as the daemon

License

MIT