OpenSSDocumentation
OpenSS documentation

Find the right path.
Get back to the work.

Practical, source-backed guidance for the macOS desktop app, Terminal CLI and localhost browser interface.

Browse product guides⌘ K to search
Choose your surface

Three interfaces. Different boundaries.

Start with the interface you are actually using. Account, provider and capture behaviour differs between them.

Native app

macOS Desktop

Hosted AI, account usage, native capture, on-device voice, and optional CLI-provider migration guidance.

Apple SiliconFree + Pro
Open guide
Terminal

CLI

Capture, OCR, chat, document automation and your own provider keys from the shell.

macOSLocal-first
Open guide
Localhost

Browser GUI

A visual interface served by openss gui from your Mac—not a hosted web chat.

127.0.0.1CLI BYOK
Open guide
Start here

Shortest working routes

01
Install the desktop appDMG, Applications and first launch
02
Run your first CLI requestKeychain setup, ask and capture
03
Capture a supported windowChrome, Word, PowerPoint and OCR
04
Use local voice inputPermissions, on-device transcription and review
Plans at a glance

Free starts with 200 AI units.
Pro includes 500 weighted units and hosted reasoning tiers.

CLI BYOK remains available for advanced users. Pro is $15/month and unlocks Mini, Luna, Terra, and Sol. Purchased AI credits extend hosted usage; they do not change plan.

Compare every capability
Free200AI units + Mini
Pro · $15/month500weighted AI units + Mini, Luna, Terra, Sol
Popular guides

Common jobs and recovery paths

Hosted AI and AI units

Understand plans, tiers, and what counts against usage.

Read guide Signed in, but AI returns 401

Refresh account and recover the local engine path.

Read guide Screen capture permissions

Set up Screen Recording and supported targets.

Read guide Privacy boundaries

Local audio and OCR versus submitted AI content.

Read guide
Latest published desktop releaseOpenSS 0.2.8macOS · Apple Silicon · signed and notarised
Download DMG TroubleshootingGitHub