Tabz

# Tabz

**Full Linux terminals in your Chrome sidebar**

![Version](https://img.shields.io/badge/version-1.4.2-blue)
![Chrome](https://img.shields.io/badge/chrome-manifest%20v3-green)
![License](https://img.shields.io/badge/license-MIT-green)

![Claude, Gemini, Codex, and Solitaire in a quad-split terminal sidebar - do some shopping while you code](docs/screenshots/hero-dark.png)

> **[Watch: Subagent chaos with audio announcements](https://youtu.be/uY-YbAW7yg4)** - Multiple Claude subagents running with different voice status updates

## What Is This?

**Real bash terminals running in your browser sidebar.** Not a web-based terminal emulator - actual Linux shells connected via WebSocket to your local machine.

Run anything you'd run in a normal terminal:
- **Claude Code, Gemini CLI, OpenAI Codex** - AI coding assistants side-by-side with your browser
- **TUI applications** - lazygit, htop, btop, vim, neovim, midnight commander
- **Development servers** - npm, yarn, docker, kubectl, any CLI tool
- **Full interactivity** - colors, mouse support, copy/paste, scrollback

Browse the web with your terminals always visible - no window juggling, no Alt+Tab. Terminals persist in tmux sessions, so they survive sidebar close/reopen and even browser restarts.

**Why this exists:** If you use AI coding tools (Claude Code, Gemini, Codex), you need terminals visible while browsing docs, PRs, and issues. Tabz keeps them docked to your browser instead of buried behind windows.

**Give your AI full control:** Through MCP tools and REST API, Claude Code can control your browser (screenshots, clicks, form filling, network inspection) and spawn/kill terminal sessions programmatically. Your AI assistant becomes a true automation partner.

> ⚠️ **Security Note:** By default, MCP tools only allow access to safe domains (GitHub, GitLab, Vercel, localhost, AI image generators). "YOLO mode" can be enabled in settings to allow all URLs, but we recommend using a **separate Chrome profile** without personal accounts or saved passwords if you do.

### Key Features

- **Persistent sessions** - Powered by tmux, terminals survive everything
- **Profiles system** - Save configurations for different tools (Claude Code, lazygit, htop)
- **Category organization** - Color-coded groups for easy identification
- **Smart directory inheritance** - Set a global working directory, profiles inherit it
- **3D Focus Mode** - Pop any terminal into an immersive full-tab 3D view (scroll to zoom, mouse to orbit, F2 to lock)
- **Terminal Popouts** - Right-click tab → "Pop Out" for standalone terminal windows (theme synced, return or detach)
- **Local dashboard** - Web UI at `localhost:8129` for terminal management and quick stats
- **Tabz MCP tools** - Let Claude Code control your browser (screenshots, clicks, form filling)
- **Keyboard shortcuts** - Quick access to paste text, send to chat, spawn terminals

### Claude Code Integration

TabzChrome is designed to work seamlessly with Claude Code:

**🚀 Quick Setup - `/discover-profiles` command**
- Scans your system for installed CLI tools (claude, lazygit, htop, nvim, etc.)
- Opens curated lists ([awesome-tuis](https://github.com/rothgar/awesome-tuis), [modern-unix](https://github.com/ibraheemdev/modern-unix)) to discover new tools
- Generates ready-to-import profiles with sensible defaults

**⚡ 0 Token Cost Up Front** - MCP tools with no context overhead!

![MCP settings](docs/screenshots/mcp-settings.png)

Using Claude Code's experimental MCP CLI mode, tool schemas are loaded on-demand instead of all 44 definitions into context. Enable with the `ENABLE_EXPERIMENTAL_MCP_CLI=true` environment variable. See the [setup gist](https://gist.github.com/GGPrompts/50e82596b345557656df2fc8d2d54e2c) for details.

**🎭 Power Features (Claude Code Integration):**

TabzChrome includes a [Claude Code plugin marketplace](.claude-plugin/marketplace.json) with agents, skills, hooks, and MCP tools:

| Component | Type | Description |
|-----------|------|-------------|
| [**Tabz MCP Server**](tabz-mcp-server/MCP_TOOLS.md) | MCP | 77 browser control tools (screenshots, clicks, bookmarks, network, tab groups, windows, history, cookies, emulation) |
| [**tabz-browser**](.claude/skills/tabz-browser/) | skill | Browser automation patterns (screenshots, forms, network debugging) |
| [**tabz-terminals**](.claude/skills/tabz-terminals/) | skill | Terminal spawning and worker management via REST API |
| [**tabz-development**](.claude/skills/tabz-development/) | skill | Terminal.tsx, xterm.js, WebSocket patterns |
| [**tabz-expert**](.claude/agents/tabz-expert.md) | agent | Browser automation specialist with 77 MCP tools |

**Quick setup:** Skills auto-load when you run Claude Code in the TabzChrome directory.

---

## Quick Start

### Requirements

| Component | Version | Notes |
|-----------|---------|-------|
| Node.js | 18+ | Backend server |
| Chrome | 116+ | Manifest V3, Side Panel API |
| tmux | 3.0+ | Session persistence |
| OS 

... (truncated)