Use a rig

You're on the consumer side of the loop. Someone (maybe you) built a rig and published it; you want to install it on your machine and use it.

The typical session looks like this:

rig hub search <topic>            # find a rig
rig hub use hub:author/name       # install it
cd name && rig install        # set up env, dirs, permissions
rig doctor                    # verify it's ready
claude                        # start working

That's the happy path. The pages here go deeper into each step.

Pages in this section

• Find a rig — searching the Hub, browsing categories, eyeballing a rig before installing.
• Install a rig (rig use) — fetching and extracting the artifact.
• Source specifiers — hub:, github:, local files, registries.
• Run setup (rig install) — the convergent setup step.
• Inspect before installing — see what's in an artifact without unpacking.
• Update a rig — pull a newer version while preserving your local state.
• Troubleshoot (rig doctor) — read the readiness report and fix gaps.

When you're done

• Building your own? Jump to Build a rig.
• Want it to be shared/collaborative? See Collaborate.