OpenSSDocumentation
DesktopCLIWeb

Getting started

Choose the right OpenSS surface and complete the shortest working setup.

Updated 22 July 2026Applies to 0.2.8 release
On this pageChoose a surfaceQuick pathImportant boundaries

Choose a surface

OpenSS has three interfaces with different account and provider behaviour. Desktop is the signed macOS application, CLI is the Terminal workflow, and Web is a browser interface served locally by the CLI.

SurfaceBest forAccount
DesktopHosted AI, native capture and voiceRequired for hosted AI
CLITerminal automation and BYOKNot required for BYOK
Local browser GUIVisual CLI workflows in a browserNot required; runs on 127.0.0.1

Quick path

  1. 1
    Desktop

    Download the Apple Silicon DMG, drag OpenSS to Applications, sign in, then send a message or capture a supported window.

  2. 2
    CLI

    Run the source installer, complete provider-key setup, then use openss ask or openss capture.

  3. 3
    Browser GUI

    Install the CLI, run openss gui, and keep that Terminal process open while using the local page.

Important boundaries