Pro & login guide

Switchman Pro adds deeper shared coordination, richer AI planning, and longer history retention. Free now includes unlimited local agents, Slack notifications, read-only session summaries, and one shared cloud project for logged-in users.

✓

Free stays meaningful. The MIT core remains available without a subscription, and the free logged-in experience now includes one shared cloud project alongside unlimited local agents.

What's included in Pro

Feature	Free	Pro
Unlimited local agents	✓	✓
Full CLI and MCP server	✓	✓
File locking and conflict detection	✓	✓
Slack notifications	✓	✓
Read-only session summaries	✓	✓
Shared cloud projects	1 project	Full team coordination
Task history retention	7 days	90 days
Deeper shared coordination across machines	Limited	✓
Team invites	Limited	✓
AI task planning	—	✓
Email support	Community	48-hour reply

Step 1 — Subscribe

Open the Pro page from your terminal:

switchman upgrade

Or visit switchman.dev/pro directly. Current pricing is $19/month per seat. Sign in with GitHub, then complete checkout via Polar.sh.

ℹ

Polar.sh acts as merchant of record — they handle VAT, sales tax, and billing automatically. Local taxes may apply depending on your location.

Step 2 — Activate in your terminal

After subscribing, run:

switchman login

This opens your browser to switchman.dev/activate. You'll see a short code like SWIFT-4829 — confirm it matches what's shown in your terminal, then sign in with GitHub. Your terminal detects the authorization automatically within a few seconds.

  Visit: https://switchman.dev/activate?code=SWIFT-4829
  Your code: SWIFT-4829

  Waiting for authorization...
  ✓ Signed in as you@github.com
  ✓ Pro licence verified — all features unlocked
  ✓ Switchman Pro active
  Plan: monthly
  Renews: 4/16/2026

Step 3 — Verify and start using Pro

switchman login --status

Should show your plan, email, and renewal date. After that you can use the deeper shared-coordination and planning workflows.

Inviting teammates

Each seat is billed individually. To invite a teammate:

switchman team invite alice@example.com

This generates an invite token. Share it with your teammate:

# Your teammate runs this:
switchman login --invite <token>

They'll be added to your shared team coordination.

switchman team list    # see all members and their status

AI task planning

With Pro active, use the planning command:

switchman plan "Add user authentication"
switchman plan "Add user authentication" --apply
switchman plan --issue 47
switchman plan --issue 47 --apply --comment

Switchman reads repo context and proposes a parallel task breakdown. It can also plan directly from a GitHub issue and optionally comment the plan back to the issue or PR.

Credentials and offline use

After login, credentials are saved to ~/.switchman/credentials.json. The licence check is cached locally for 24 hours — you don't need internet access for every command.

If you're offline, Switchman uses the cached credentials for up to 7 days before requiring a reconnect.

Signing out

switchman logout

This removes saved credentials. Pro features will be unavailable until you run switchman login again.

Cancelling

Cancel through Polar.sh — your subscription runs until the end of the billing period then stops. Your local SQLite data and history are always yours and are not affected by cancellation.

Getting help

Pro subscribers get email support with a 48-hour reply time. Email hello@switchman.dev with your subscription email and we'll help you out.