worktab

Bridge extension for worktab — a macOS desktop app for managing multiple editor workspaces like browser tabs.

This extension forwards Claude Code task events (e.g. "input required" notifications) from your development environment to the worktab desktop app.

How it works

Claude Code hook → /tmp/worktab-events → Extension (workspace) → Webview bridge (local) → worktab app (localhost:19384)

The extension uses a Webview bridge pattern — the Webview always runs on the local machine (guaranteed by VS Code), so it can reach the worktab desktop app via localhost even when the extension itself runs on a remote host.

Requirements

• worktab desktop app running on your local machine
• Claude Code (for task event hooks)

Setup

1. Install the extension
2. Run the command "worktab: Setup Claude Code Hook" from the Command Palette (Cmd+Shift+P)
3. Restart Claude Code

The activity bar will show a connection indicator:

• Green — connected to worktab
• Red — worktab is not reachable (make sure the desktop app is running)

Features

• Forwards Claude Code idle/completion events to worktab
• Works in both local and remote (SSH / DevContainer) environments
• Connection health monitoring with visual status indicator
• Automatic event buffering when worktab is temporarily unavailable