Quick Start

This guide helps you install Rig, browse your local agent skills, and connect usage tracking.

Install the App

1. Download the latest macOS build.

2. Open the downloaded .dmg.

3. Drag Rig into your Applications folder.

4. Launch Rig.

Browse Your First Skills

Rig automatically checks these default skill roots:

• ~/.agents/skills
• ~/.config/opencode/skills
• ~/.claude/skills

Open the Skills view, choose Global, and select a skill from the sidebar to inspect its metadata and content.

Install Plugins

Plugins let Rig track which agent skills are actually being used.

OpenCode

Add rig-opencode to your OpenCode config. The config file is usually at ~/.config/opencode/opencode.json.

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["rig-opencode"]
}

Restart OpenCode after saving the config. OpenCode installs npm plugins automatically at startup.

Claude Code

Add the Rig Claude Code marketplace and install the plugin:

/plugin marketplace add builder-mafia/rig
/plugin install rig-claude-code@rig
/reload-plugins

Next Steps

• Learn how Skill Roots work
• Learn how Usage Tracking works