dots-swe

Dots Claude Plugins

Claude Code plugin marketplace for Dots Workbench development and operations.

Available Plugins

Plugin	For	Context	Description
dots-swe	Any developer	Any project	Worktree management with tmux + iTerm2, beads integration
dots-dev	Human developers	Outside Dots app	Worktree workflows with iTerm, bead integration
dots	Dominus (Claude)	Inside Dots app	Vibe management via tmux + dots-mcp

Which Plugin Should I Use?

Use dots-swe if you are:

• Working on any project (not just Dots)
• Want tmux session persistence (re-attach after iTerm2 restart)
• Using beads for issue tracking
• Want features from the same epic grouped as tabs

Use dots-dev if you are:

• A human developer working specifically on Dots
• Running Claude Code in a terminal (iTerm, Terminal.app)
• Working outside the Dots Workbench application
• Creating worktrees for feature development

Use dots if you are:

• Dominus (Claude running in the Dots App's Dominus Console)
• Spawning Servus workers to complete beads
• Operating inside the Dots Workbench application
• Managing vibes (worker sessions) programmatically

Plugin Details

dots-swe (Software Engineering)

General-purpose plugin for any project. Uses tmux for session persistence with iTerm2 integration.

# Install
claude plugin install dots-swe@dots-claude-plugins

# Commands
/dots-swe:work <bead-id>              # Start work from bead (creates worktree, claims task)
/dots-swe:worktree-create <branch>    # Create worktree(s) with Claude sessions
/dots-swe:worktree-list               # List all worktrees
/dots-swe:worktree-status             # Dashboard showing all worktrees
/dots-swe:worktree-attach [session]   # Re-attach iTerm2 to tmux sessions
/dots-swe:worktree-sync [name]        # Sync worktree with main branch
/dots-swe:worktree-delete <name>      # Delete worktree(s) and clean up
/dots-swe:check                       # Run quality gates: test, lint, build
/dots-swe:ship                        # Full protocol: test, lint, build, PR, CI watch
/dots-swe:beads                       # Show available work
/dots-swe:doctor                      # Health check
/dots-swe:help                        # Show all commands

tmux Integration:

• Features from the same epic share a tmux session (appear as iTerm2 tabs)
• Sessions persist when iTerm2 closes
• Re-attach with /dots-swe:worktree-attach <session>
• Claude starts with --dangerously-skip-permissions --model opus

iTerm2 Setup Required:

• Settings > General > tmux > "Open tmux windows as: Tabs in a new window"
• Settings > General > tmux > "Automatically bury the tmux client session after connecting"

dots-dev (Human Development)

For human developers building Dots. Creates worktrees with iTerm tabs running Claude sessions.

# Install
claude plugin install dots-dev@dots-claude-plugins

# Commands
/dots-dev:worktree-create <branch>  # Create worktree + iTerm tab
/dots-dev:worktree-list             # List all worktrees
/dots-dev:worktree-delete <branch>  # Delete worktree
/dots-dev:worktree-handoff          # Prepare for PR
/dots-dev:ship                      # Full ship protocol (test, lint, build, PR)

Full Documentation

dots (Dominus Operations)

For Dominus managing Servi inside the Dots App. Creates worktrees with headless tmux sessions via dots-mcp.

# Install (in Dominus Console)
claude plugin install dots@dots-claude-plugins

# Commands
/dots:vibe-spawn <bead-id>           # Spawn Servus worker
/dots:vibe-list                      # List active vibes
/dots:vibe-kill <bead-id>            # Kill vibe and cleanup
/dots:vibe-status <bead-id> <status> # Report status to UI

Full Documentation

Installation

For Human Developers

The Dots repository has this marketplace pre-configured. When you run claude in the Dots repo, plugins are automatically available.

To manually install:

claude plugin install dots-dev@dots-claude-plugins

For Dominus (Dots App)

The Dots App configures the dots plugin automatically. Dominus can use /dots:* commands directly.

Upgrading Plugins

When to Upgrade

Upgrade your plugins when:

• New features are added (check the commit history)
• Bug fixes are released
• You see "plugin version mismatch" warnings

How to Upgrade

# Check current version
claude plugin list

# Upgrade a specific plugin
claude plugin upgrade dots-dev@dots-claude-plugins
claude plugin upgrade dots@dots-claude-plugins

# Or reinstall to get the latest
claude plugin uninstall dots-dev@dots-claude-plugins
claude plugin install dots-dev@dots-claude-plugins

Breaking Changes