Help

How to set up ModelCaptain, manage your license and fix common problems. Can’t find your answer? Email help@macl.app.

Getting started

ModelCaptain doesn’t include its own AI. The Captain plans your work and hands tasks to AI coding tools you already have, signed in with your own subscription. You need at least one of them.

  1. Download and install ModelCaptain for Windows, macOS or Linux from the Download page.
  2. Install at least one AI tool and sign in to it (see below).
  3. Open ModelCaptain and go to Connections. Each tool has a status dot. Press Check again after you install a tool or sign in.
  4. Go back to the chat, say what you want done and send it. The Captain picks the coworkers and models and brings the results back to the chat.

On the Connections page, each tool has an Install button (opens the tool’s official install page in your browser) or, once it’s installed, a Sign in button. Sign in opens a terminal window with the tool’s own sign-in. When you’re done there, press Check again.

Claude Code (Anthropic)

For a Claude Pro or Max plan. Install: follow the Claude Code setup guide. Sign in: press Sign in next to Claude, or run claude in a terminal. Type /login in the window that opens and choose your Claude subscription.

OpenAI Codex

For a ChatGPT Plus or Pro plan. Install: follow the Codex CLI guide. Sign in: press Sign in next to Codex, or run codex login. Choose “Sign in with ChatGPT” so Codex uses your ChatGPT plan, not API credits.

Cursor Agent

For a Cursor Pro or Ultra plan. Install: follow the Cursor CLI guide. Sign in: press Sign in next to Cursor, or run cursor-agent login. Sign in with the Cursor account that has your plan.

Grok (xAI)

For a SuperGrok or X Premium+ plan. Install: follow the Grok CLI guide. Sign in: press Sign in next to Grok, or run grok login. Sign in with the X or xAI account that has your Grok plan.

Each tool also has an on/off switch on the Connections page. Turn a tool off if you don’t want the Captain to use it.

Your license

Free trial

The 7-day free trial starts the first time you open ModelCaptain. You don’t need to sign up or enter a card. Account shows how many days are left. When the trial ends, your chats and files stay where they are; pick a plan to keep giving the crew new work.

Buy a plan

Plans are $15/month or $144/year. Payment is handled by Polar.

  1. Open Account and choose Monthly or Yearly. You can also buy on the Pricing page.
  2. Checkout opens in your browser. Your license key arrives by email. It starts with MC-.

Activate your key

  1. Open Account in ModelCaptain.
  2. Paste your key into the license key box.
  3. Press Activate.

One key works on up to 3 of your own computers.

Move to another computer

  1. On the old computer, open Account and press Deactivate on this computer. This frees that computer’s seat.
  2. On the new computer, open Account, paste the same key and press Activate.

“Already active on its maximum number of computers”

Your key is in use on 3 computers. Open Account on one you no longer use and press Deactivate on this computer, then activate again. If you no longer have that computer, email help@macl.app.

Working offline

ModelCaptain checks your license about once a day. If it can’t reach the license server, it keeps working offline for up to 14 days. After that, connect to the internet and press Check again on the Account page. Your AI tools still need the internet to do their work.

Cancel or change your plan

Press Manage subscription on the Account page, or go to the customer portal. There you can manage or cancel your subscription.

Usage limits

ModelCaptain runs on your own AI subscriptions, so each plan’s usage limits still apply. ModelCaptain doesn’t work around them.

  • When a tool runs out of usage, its dot turns amber and shows when it should be back. The Captain sends new tasks to your other connected tools.
  • If no connected tool has usage left, the work can’t continue until a limit resets. A repeating prompt waits for the earliest reset and then carries on.
  • If you think a limit has already reset, press Try again now on the Connections page.

Use one subscription first

By default the Captain picks the best model for each task from all your connected tools. To use up one plan first, click Best model in the row of connection dots under the chat and choose Use Claude first (or Codex, Cursor or Grok). It switches back to normal on its own when that tool runs out of usage.

Bill my API key

By default ModelCaptain uses your subscription sign-in and ignores API keys in your environment. If you’d rather pay per use, turn on Bill my API key for a tool on the Connections page. That tool then uses your key from the environment (ANTHROPIC_API_KEY, OPENAI_API_KEY or CODEX_API_KEY, CURSOR_API_KEY, or XAI_API_KEY). Charges go to your API account with that provider, not to your subscription, and they can add up quickly.

Phone access

Check on your crew and send work from your phone.

  1. In ModelCaptain, open Account and find the Phone section.
  2. Turn on Phone access.
  3. Press Pair a phone. A QR code appears.
  4. Point your phone’s camera at the code and tap the link.
  5. Tap Connect.

The code works once and expires after 10 minutes. Your phone reaches your computer through the ModelCaptain relay, so it works anywhere your phone has internet. The connection is encrypted end to end, so the relay can’t read your prompts or results. Your computer must stay on and awake, with ModelCaptain open.

To remove a phone, press Remove next to it in the same Phone section. It will need to be paired again to reconnect.

Troubleshooting

ModelCaptain couldn’t find that tool on your computer. Press Install on the Connections page and follow the official guide. Then press Check again.

Press Sign in on the Connections page and finish signing in in the terminal window that opens. Then press Check again.

For Codex, “Using API key” means Codex is signed in with an API key instead of ChatGPT. Press Sign in and choose “Sign in with ChatGPT”, or turn on Bill my API key if you want to pay with your API account.

The Connections page shows “Limit reached” and when it should be back. The Captain uses your other connected tools in the meantime. Connect another tool, wait for the reset, or press Try again now if you think it has already reset. See Usage limits.

In Auto mode, coworkers edit the workspace and run commands, but they ask before going outside it or using your computer. When that happens, the chat shows Needs your OK. Press Allow to let the task continue, or Don’t allow to skip that part.

You can change the mode for a chat from the mode menu next to the message box: Auto, Full access (coworkers can use your whole computer and any folder without asking) or Read only (they can look and plan, but not change anything). Only use Full access for work you trust.

During the beta you may see a security warning the first time you open ModelCaptain. Only do this for a copy you downloaded from the Download page.

Windows (“Windows protected your PC”): click More info, then Run anyway.

macOS (“can’t be opened”): right-click ModelCaptain in Applications and choose Open. Or go to System Settings → Privacy & Security and click Open Anyway.

By default, each chat gets its own folder inside Documents/ModelCaptain on your computer. Use the folder button in a chat to open its files, show the folder in Explorer or Finder, or choose a different folder.

Open Account to see the reason. If ModelCaptain couldn’t confirm your license for a while, connect to the internet and press Check again. If your subscription ended, renew it from Manage subscription. If the key was deactivated on this computer, paste it again and press Activate.

Email help@macl.app. Include your ModelCaptain version (shown under About on the Account page), your operating system and what you were trying to do.

Privacy

ModelCaptain runs on your computer. Your chats, files and prompts stay there, except what your connected AI tools send to their own providers under those providers’ terms. Once a day, ModelCaptain checks your license with Polar, our payment provider, sending only the license key and your computer’s name. Phone access goes through the ModelCaptain relay, encrypted end to end. For details, see the Privacy Policy.

ModelCaptain is an independent product and isn’t affiliated with Anthropic, OpenAI, Anysphere or xAI.