MRigbolt Documentation
Documentation/Getting started
Quickstart / Complete setup

From download to
your first real task.

Install Rigbolt on your Mac, connect the AI client you already use, and confirm that it can inspect your own project. This is a real setup guide, not a feature tour.

Your setup path
Install app→Choose folder→Connect AI→Test a task
Before starting: a Mac, Rigbolt installer, an AI client, and a project folder (or the built-in demo workspace). For web AI clients, a Cloud connection is also required.
01

Install Rigbolt on your Mac.

Use the official macOS installer. Keep the app running while your AI client uses local tools.

  1. Open the Rigbolt Downloads page ↗, or the verified download link provided with your purchase.
  2. Download the release that supports your Mac. If supplied as a DMG, open it and drag Rigbolt.app to Applications.
  3. Open Rigbolt from Applications and follow the first-run screens. Only approve macOS permissions that you understand and need.
✓
You should see: The Rigbolt application opens and shows the first-run workspace setup or Home view. If macOS warns about an unverified build, confirm you downloaded the genuine signed release rather than bypassing safeguards.
~2 minutes after download
02

Choose a project AI can access.

Rigbolt works inside a workspace on your Mac. Start with one folder you recognize—do not grant broader access than you need.

  1. In the first-run setup, choose Add a project (or Try the safe demo project).
  2. Select your development folder, such as a project containing package.json, .git, or WordPress source.
  3. Leave the default Projects Only access scope unless you deliberately need Full Mac Access. Continue to the workspace/Home screen.
◼ Rigbolt / ProjectsIllustrative layout
📁 my-projectAdded
Access scopeProjects Only
This is a schematic example, not a screenshot of the shipped application.
✓
You should see: Your project listed inside Rigbolt. AI access is scoped to its allowed workspace, subject to macOS permissions.
Project path stays on your Mac
03

Connect your AI client.

Web chat and desktop AI clients use different connection paths. Choose yours below. You only need to complete one.

ChatGPT Web → Rigbolt Cloud → Your Mac

Read the complete ChatGPT connection guide ↗

ChatGPT accesses your paired Mac through Rigbolt's public HTTPS MCP endpoint. Custom MCP connection options depend on your ChatGPT plan and workspace permissions.

  1. Keep Rigbolt open. In Rigbolt Connections or Settings → Connections & Remote, choose the managed Rigbolt Cloud connection and complete pairing/authorization.
  2. Verify that your device shows connected or online in Rigbolt.
  3. In ChatGPT, if your plan/workspace allows custom MCP apps, enable Developer Mode, create a custom MCP app, and enter Rigbolt as the name with the endpoint below.
  4. Complete the authentication flow, review the requested access, and make the Rigbolt connection available in your chat.
https://rigbolt.tophive.dev/mcp

Official ChatGPT connection instructions ↗

If your ChatGPT plan does not allow custom MCP servers, you will need a compatible client or eligible plan. Rigbolt cannot override AI-provider restrictions.
✓
You should see: Your selected AI client recognizes Rigbolt and exposes its supported tools. For a web client, the Mac must remain online and Cloud paired.
Complete only one client path
04

Run a safe first task.

Start in read-only mode. This confirms the connection works without changing files.

  1. Open a new conversation in the AI client you connected.
  2. Make sure Rigbolt tools or its custom connector are available to that conversation.
  3. Copy the prompt below and send it to your AI assistant.
  4. Review the results against the actual project in Rigbolt. Ask for changes only after inspection succeeds.
Safe starter prompt
Using Rigbolt, inspect my selected project. Tell me its root folder, detected stack, and key files. Do not modify any files or run destructive commands.
✓
You should see: A real project summary based on Rigbolt tool results, not a generic AI guess. Confirm the reported folder and files exist on your Mac.
Read-only first
05

Understand changes and approvals.

When you're ready for writes, Rigbolt follows its local access and approval settings. Its dedicated Git commit action requires explicit review.

  1. Open Rigbolt Live Sessions or History to see recent operations.
  2. For code changes, review files and diffs in Code Review.
  3. When Rigbolt requests approval, inspect the exact operation before accepting.
  4. After execution, verify the result using a build/test or direct inspection. Execution success alone is not verification.
Rigbolt does not impose a local tool-call credit limit in its current Personal model; your AI client may have separate plan and usage limits. Do not confuse a local policy prompt with a billing limit.
✓
You should see: A reviewable change history and a clear result for executed and verified work.
Your Mac remains the authority
?

Having trouble?

Start with these practical checks. You don't need to reset or delete Rigbolt data to troubleshoot a connection.

My AI client can't see Rigbolt tools

Confirm Rigbolt is running. For local clients, reopen Rigbolt Connections, check the client configuration status, restart the client, and try a new conversation. For web clients, verify Cloud pairing and that your AI plan supports the custom connector.

Cloud says the Mac is offline

Keep your Mac awake and Rigbolt open, verify the app's Cloud status, internet connection, and device pairing. The remote endpoint alone does not mean your Mac is reachable.

AI can connect, but can't access my project

Open Rigbolt Projects and confirm the folder is added. With Projects Only scope, unregistered folders are outside the allowed workspace. Also check macOS filesystem permissions.

An operation asks for approval

That can be intentional. Check the operation in Rigbolt, review the exact requested action, and approve only if it matches what you wanted. If the operation failed verification, inspect the failure before retrying.

I got the app but don't have an installer or activation details

Use your official product/download channel. The purchase receipt, licensing workflow, and installer distribution must be verified against the shipping release before final publication of these docs. Do not use a random third-party DMG.

YOU'RE READY

Now build something real.

You have a connected Mac, a chosen project, and a verified first task. Start with a small change, review the diff, and confirm the result.

← Documentation homeGet support ↗
Prototype guide. Screens and purchase/entitlement steps require final release validation.