Rig

Portable, runnable agent workspaces.

A rig is a folder that bundles everything an AI coding agent needs — system prompts, MCP servers, tool configs, data, and setup instructions — into a single portable package. Install one and start working in seconds.

npm install -g @rigxyz/cli

rig hub search market-researcher
rig hub use hub:maria/market-researcher
cd market-researcher && claude

Commands

# Rig — the package
init               Initialize a new rig (--no-sync for local-only)
add <pattern>      Add files/patterns to package.include
pack               Package into a .rig.tgz artifact
install            Run setup hooks for the current rig
inspect <source>   Show artifact metadata
doctor             Check workspace readiness

# Workspace — live & shared
sync [--off]       Mirror this workspace to your web Home (go live)
share [<email>]    Invite a person (or --ops … for scoped/agent access)
who                Members, invites, scoped access
unshare <target>   Revoke a grant
join <url>         Join someone else's workspace
status [--verbose] Live? syncing? who's on it
disconnect         Stop being a synced workspace (local)

# Hub — distribution
hub publish        Publish this rig to the Hub
hub use <source>   Install a rig
hub update [src]   Update an installed rig
hub search <query> Search Rig Hub
hub list           List a registry

# Account
login / logout     Authenticate with Rig Hub

Sources

Rigs can be installed from multiple sources:

hub:author/name[@ver]       Rig Hub (userig.xyz)
github:user/repo[@ver]      GitHub release
./path.rig.tgz              Local artifact
registry:author/name        Local file registry

How it works

# 1. Start from any agent folder
cd my-agent-workspace

# 2. Initialize — detects MCP servers, env vars, tools, plugins
rig init

# 3. Optionally add files/folders to share
rig add strategies/**
rig add data/reference/companies.json

# 4. Package into a portable artifact
rig pack

# 5. Publish to the Hub
rig login
rig hub publish

# 6. Anyone can install and run it
rig hub use hub:you/my-agent-workspace
rig install
rig doctor

rig init scans your folder and infers setup metadata: MCP server names, required tools (uvx, npx, uv), env vars from config placeholders, plugin hints, permissions (allow/deny rules from .claude/settings.json), install commands, and workspace directories. By default, only configuration files (.claude/**, CLAUDE.md, .mcp.json, etc.) are included — folder contents are not shared unless you opt in via interactive init or rig add.

Permissions declared in [permissions] are written to .claude/settings.json during install, so users don't face permission dialogs they don't understand. Rig merges its rules with existing user permissions (union merge, deny wins).

rig doctor provides a live machine-readable readiness check. Agents like Claude Code use it to self-heal broken workspaces.

Share a live workspace

Publishing ships a copy. Sharing makes the folder itself multiplayer — files sync in seconds between everyone on it, with an activity feed, chat channel, and comments on the web.

# Mirror the workspace to your web Home (private to you)
rig sync

# Invite a teammate — prints a userig.xyz/join/… link to send them
rig share [email protected]

Your teammate opens the link, which walks them through getting a synced copy (rig join <link>). They can also follow along on the web — files, activity, and comments live at the workspace's page on userig.xyz.

rig who shows who's on a workspace, rig unshare <email> removes them, and rig sync --off takes the workspace back to local-only.

Organizations group workspaces and packages under a team. Create one at userig.xyz/home (org switcher → "Create organization…"), then rig sync --org <slug> to put a new workspace under it, or rig publish --org <slug> to publish a package to the org's registry.

Hub

Rig Hub is the community registry. Browse, search, and install agent workspaces published by others.

Links

• Rig Hub
• Manifesto
• CLI Docs