SwitchApp CLI

Run Switch from your terminal. Sign in with your browser, see your real token balance, and create content with the same account you use on switchapp.ai. You never need a model or provider API key.

1. Install

Open Terminal (on a Mac: press Command-Space, type “Terminal”, press Return). Paste this one command and press Return:

curl -fsSL https://cli.switchapp.ai/install.sh | bash

The installer detects your computer (Mac with Apple Silicon or Intel, or Linux), downloads a standalone app — no Node, no admin password — and refuses to install anything that fails its security signature and checksum checks. It adds SwitchApp to your PATH automatically.

2. Run SwitchApp and sign in

Open a new Terminal window and type:

SwitchApp

Your browser opens to sign in to your existing Switch account. Approve the request and return to the terminal — you are signed in until you sign out or revoke access in Switch. Your login is stored in your Mac’s Keychain (or a private file on Linux), and SwitchApp will never ask you for an API key — model keys live on Switch servers only.

3. Start creating

Typing SwitchApp starts a conversation with the Switch Operator: describe what you want in plain English and it plans stories, shot lists, scripts, ads, and campaigns using your real account. Useful commands outside chat:

4. Slash commands

Inside chat, type / and press Tab to see every command. Highlights:

Your saved workflows appear here too: saving “my-real-estate-style” gives you /my-real-estate-style in chat.

5. Reusable workflows

A workflow saves your creative rules once — lighting, camera language, aspect ratio, duration, music, brand, a token ceiling — so every future run stays on-brand while the property, product, or brief changes.

# Save your style once
switchapp workflow create my-real-estate-style \
  --skill real-estate \
  --set style="warm dusk light, natural wood tones" \
  --set camera="slow dolly forward, wide 24mm lens" \
  --set aspect="9:16" --set duration="60s" \
  --set music="soft ambient piano" \
  --input address:"Property address":required

# Run it forever with new inputs
switchapp workflow run my-real-estate-style \
  --input address="12 Ocean Drive, Miami" "listing teaser"

Every edit saves a new version and old versions stay restorable: workflow version lists them, workflow version --restore 1 brings one back. duplicate, export, import, and share move workflows between machines and teammates as plain files that never contain login details. A workflow’s token ceiling refuses any run priced above it, before any charge.

6. Mini apps and automations

A mini app chains your workflows into a small tool — described entirely in one file, no code — with inputs, branching, and a spending limit:

switchapp app create listing-machine   # scaffolds a working example
switchapp app test listing-machine     # dry run: no sign-in, no charges
switchapp app run listing-machine --input address="44 Harbor Lane"
switchapp app deploy listing-machine   # run it by name from anywhere

Paid steps show their price and ask first. Every run keeps a journal, so if anything is interrupted, --resume continues where it stopped and finished steps replay free. The app’s tokenLimit stops a run before it can overspend. To move an app to another machine, copy its app.json and deploy it there.

7. Token costs and receipts

Everything paid is priced in Switch tokens and shown before you commit. Every completed turn prints a receipt line — model, tokens charged, and your new balance. The billing rules the service enforces:

• Every paid request has a unique request ID; the same ID can never charge twice.
• A successful request charges exactly once; a failed one refunds exactly once.
• If the network drops mid-request, the request stays pending instead of guessing — /retry reuses the original ID safely.

See spending anytime with switchapp balance or /balance in chat, and full history in Switch settings.

8. Update, roll back, troubleshoot, uninstall

Update — re-run the install command; it fetches the latest signed release:

curl -fsSL https://cli.switchapp.ai/install.sh | bash

Pin a version — SWITCHAPP_VERSION=v0.1.0 bash at the end instead of plain bash.

Roll back — the previous version stays on disk:

switchapp-rollback

Troubleshoot

• “command not found: SwitchApp” — open a new Terminal window (the PATH change applies to new windows), or run export PATH="$HOME/.switchapp/bin:$PATH".
• “Your Switch login expired” — type SwitchApp and approve the browser sign-in again.
• Signature or checksum failure during install — nothing was installed; that is the installer protecting you. Try again, and if it repeats, the download was tampered with or corrupted in transit.

Uninstall — removes the app and versions; your workflows and apps live separately in ~/.switch:

rm -rf ~/.switchapp

Then delete the “Added by the SwitchApp installer” line from your shell profile, and sign out of the session with switchapp logout first if you want the server session revoked too.