BeClaude

dots-dev

New
Community RegistryGeneralby Objectiveous

Developer tools for Dots Workbench - worktree management, specialist agents, and internal workflows

Community PluginView Source

Overview

Claude Code plugin marketplace for Dots Workbench development and operations.

Available Plugins

PluginForContextDescription
`dots-swe`Any developerAny projectWorktree management with tmux + iTerm2, beads integration
`dots-dev`Human developersOutside Dots appWorktree workflows with iTerm, bead integration
`dots`Dominus (Claude)Inside Dots appVibe 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.

bash
# 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.

bash
# 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.

bash
# 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:

bash
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

bash
# 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

v2.0.0 (Plugin Separation)

  • •dots-dev no longer includes Dots UI registry functions
  • •dots-dev dispatch files use handoff workflow (not report_status)
  • •New dots plugin for Dominus operations
  • •If you were using dots-dev for Dominus operations, switch to dots

Architecture

code
┌─────────────────────────────────────────────────────────────┐
│  Human Developer (Terminal)                                  │
│  ┌─────────────────────────────────────────────────────────┐│
│  │ /dots-dev:worktree-create feature/my-branch             ││
│  │ → Creates worktree + opens iTerm tab with Claude        ││
│  └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│  Dots App (Dominus Console)                                  │
│  ┌─────────────────────────────────────────────────────────┐│
│  │ /dots:vibe-spawn dots-d82.3                             ││
│  │ → Creates worktree + tmux session via dots-mcp          ││
│  │ → Registers in ~/.dots/sessions.json                    ││
│  │ → Servus appears in UI sidebar                          ││
│  └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘

Documentation

DocumentDescription
dots-dev/README.mdHuman developer guide
dots/README.mdDominus operations guide
CLAUDE.mdProject guidance for Claude Code
AGENTS.mdInstructions for beads workflow

Plugin Structure

code
dots-claude-plugins/
├── .claude-plugin/
│   └── marketplace.json    # Marketplace manifest
├── dots-dev/               # Human development plugin
│   ├── .claude-plugin/
│   │   └── plugin.json
│   ├── commands/           # Slash commands
│   ├── agents/             # Specialist agents
│   └── scripts/            # Shared utilities
└── dots/                   # Dominus operations plugin
    ├── .claude-plugin/
    │   └── plugin.json
    ├── commands/           # Vibe management commands
    └── README.md

Adding a New Plugin

  1. Create a new directory: my-plugin/
  2. Add .claude-plugin/plugin.json with at minimum: {"name": "my-plugin"}
  3. Add components (commands/, agents/, skills/, hooks/)
  4. Register in .claude-plugin/marketplace.json

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/dots-dev.md https://raw.githubusercontent.com/objectiveous/dots-claude-plugins/main/SKILL.md
3
Invoke in Claude Code
/dots-dev
View source on GitHub
agent

Frequently Asked Questions

What is dots-dev?

Developer tools for Dots Workbench - worktree management, specialist agents, and internal workflows

How to install dots-dev?

To install dots-dev, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /dots-dev.

What is dots-dev best for?

dots-dev is a community categorized under General. It is designed for: agent. Created by Objectiveous.