tabz-guide

Progressive disclosure guide to TabzChrome capabilities. This skill should be used when users ask about profiles, terminal management, browser automation, MCP tools, audio/TTS notifications, integration, debugging, API, or setup. Provides on-demand help organized by topic with references to detailed documentation.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️2downloads

When & Why to Use This Skill

This Claude skill serves as a comprehensive progressive disclosure guide for TabzChrome, a powerful browser extension that integrates persistent Linux terminals directly into the Chrome sidebar. It provides users with instant access to documentation on terminal management, profile customization, and advanced browser automation via 71 specialized MCP tools. By bridging the gap between the browser and the command line, it enables developers to streamline their workflow through API integrations, neural TTS notifications, and sophisticated debugging utilities.

Use Cases

  • Terminal Workflow Optimization: Learn how to create and manage persistent terminal profiles with custom themes, startup commands, and smart directory inheritance for a seamless coding environment.
  • Advanced Browser Automation: Master the use of 71 MCP tools for tasks such as automated screenshots, DOM manipulation, cookie management, and network emulation directly from the terminal.
  • Programmatic Integration: Implement the Spawn API and Markdown triggers to launch terminals or execute commands programmatically from external scripts or documentation.
  • Real-time Status Monitoring: Configure neural text-to-speech (TTS) notifications and visual indicators to track Claude's thinking process, tool usage, and context window limits.
  • Environment Debugging: Access essential commands and health check procedures to troubleshoot backend connectivity, session persistence, and terminal rendering issues.
nametabz-guide
description"Progressive disclosure guide to TabzChrome capabilities. This skill should be used when users ask about profiles, terminal management, browser automation, MCP tools, audio/TTS notifications, integration, debugging, API, or setup. Provides on-demand help organized by topic with references to detailed documentation."

TabzChrome Guide

TabzChrome is a Chrome extension providing full Linux terminals in your browser sidebar with persistence, profiles, and browser automation.

When to Use This Skill

Trigger on questions about:

  • Profile creation and management
  • Terminal spawning and API integration
  • MCP browser automation tools
  • Audio/TTS notifications and settings
  • Debugging terminal issues
  • Recent features and changes

Quick Reference

Profiles

Profiles are templates for spawning terminals with saved settings (theme, font, directory, startup command).

To create a profile:

  1. Open Settings (⚙️) → Profiles tab
  2. Click "Add Profile"
  3. Set name, category, theme, font size
  4. Optional: working directory (empty = inherits from header)
  5. Optional: startup command (e.g., lazygit, htop)

Key features:

  • Smart directory inheritance from header
  • Categories with 9 colors (collapsible)
  • Import/Export as JSON
  • Drag-drop reordering in dashboard

Integration

Markdown Links - Create runnable buttons in .md files viewed in dashboard:

[Run Tests](tabz:spawn?cmd=npm%20test&name=Tests)
[Launch Claude](tabz:spawn?profile=claude%20code)
[Queue to Chat](tabz:queue?text=git%20status)
[Paste to Terminal](tabz:paste?text=pwd)
Action Format Button Color
Spawn tabz:spawn?cmd=xxx Green
Spawn profile tabz:spawn?profile=name Green
Queue to chat tabz:queue?text=xxx Blue
Paste to terminal tabz:paste?text=xxx Orange

Spawn API - Create terminals programmatically:

TOKEN=$(cat /tmp/tabz-auth-token)
curl -X POST http://localhost:8129/api/spawn \
  -H "Content-Type: application/json" \
  -H "X-Auth-Token: $TOKEN" \
  -d '{"name": "Worker", "workingDir": "~/projects", "command": "claude"}'

HTML triggers - Add to any web page element:

<button data-terminal-command="npm run dev">Start Dev</button>

For full API documentation, read references/api-endpoints.md.

MCP Tools

71 tools for browser automation: screenshots, clicks, downloads, network capture, debugger, audio/TTS, history, sessions, cookies, emulation, and notifications.

Quick example:

mcp-cli info tabz/tabz_screenshot       # Check schema first
mcp-cli call tabz/tabz_screenshot '{}'  # Capture viewport
Category Tools
Tab Management list_tabs, switch_tab, rename_tab
Screenshots screenshot, screenshot_full
Interaction click, fill, execute_script
Downloads download_image, download_file, cancel_download
Debugger get_dom_tree, profile_performance, get_coverage
Audio/TTS speak, list_voices, play_audio
History history_search, history_visits, history_recent, history_delete_*
Sessions sessions_recently_closed, sessions_restore, sessions_devices
Cookies cookies_get, cookies_list, cookies_set, cookies_delete, cookies_audit
Emulation emulate_device, emulate_geolocation, emulate_network, emulate_media, emulate_vision
Notifications notification_show, notification_update, notification_clear, notification_list

Visual Feedback: Elements glow when tools interact (🟢 click, 🔵 fill, 🟣 inspect).

Getting Selectors: Right-click any element → "Send Element to Chat" for unique CSS selector.

For complete tool reference, read references/mcp-tools.md.

Debugging

Essential commands:

ps aux | grep "node server.js" | grep -v grep  # Backend running?
tmux ls | grep "^ctt-"                          # List terminals
curl http://localhost:8129/api/health           # Health check

For common issues and solutions, read references/debugging.md.

Audio/TTS

Neural text-to-speech notifications for Claude Code status changes. Audio generated via edge-tts, played through Chrome.

Key settings (Settings → Audio):

  • Voice: 10 neural voices, or "Random" for unique voice per terminal
  • Rate: Speech speed (-50% to +100%)
  • Pitch: Voice pitch (-200Hz to +300Hz) - higher = more urgent
  • Events: Ready, session start, tools, subagents, context warnings

Context alerts auto-elevate pitch + rate:

  • 50% warning: +100Hz, +15% rate
  • 75% critical: +200Hz, +30% rate

API example:

curl -X POST http://localhost:8129/api/audio/generate \
  -H "Content-Type: application/json" \
  -d '{"text": "Task complete", "pitch": "+20Hz"}'

For voice codes, parameters, and API details, read references/audio-tts.md.

Recent Features

Version Key Feature
1.2.19 Codebase simplification (MCP client removed, hooks extracted)
1.2.8 Send Element to Chat, MCP visual feedback, debugger tools
1.1.16 tabz-guide plugin, tui-expert agent
1.1.15 Context window % on tabs, audio alerts
1.1.14 3D Focus Mode

For full changelog, read references/changelog.md.

Advanced Topics

Ghost Badge (Detached Sessions)

To free tab space while keeping sessions alive:

  1. Right-click tab → "👻 Detach Session"
  2. Ghost badge (👻) appears in header with count
  3. Click badge → Reattach or Kill sessions

Claude Status Tracking

Tabs show live Claude status with emoji indicators:

  • 🤖✅ Ready/waiting
  • 🤖⏳ Thinking
  • 🤖🔧 Using tool
  • 🤖🤖 Subagents running

Voice pool: Select "Random (unique per terminal)" to distinguish multiple Claude sessions.

Renderer Toggle

Toggle WebGL/Canvas in header (GPU icon):

  • Canvas (default): Works everywhere, supports light mode
  • WebGL: GPU-accelerated, dark mode only

File Locations

Paths relative to TabzChrome installation directory.

File Purpose
README.md User guide
docs/API.md REST API reference
CHANGELOG.md Version history
tabz-mcp-server/MCP_TOOLS.md MCP tools reference
docs/PLUGIN.md Plugin/hook setup

Essential Commands

# Backend
./scripts/dev.sh                  # Start backend (tmux session)

# Build
npm run build                     # Build extension

# MCP
mcp-cli info tabz/<tool>          # Check schema (REQUIRED)
mcp-cli call tabz/<tool> '{...}'  # Call tool

# API
curl http://localhost:8129/api/health

For detailed information on any topic, read the corresponding file in references/.