Quick start

Requirements

• Apple-silicon macOS 14 or newer;
• an installed, executable skryba binary;
• the credentials required by the chosen CLI workflow.

Install the CLI from the sibling repository:

cd ../skryba
cargo install --path .

Skryba Desktop searches PATH, then ~/.cargo/bin, ~/.local/bin, ~/.stado/bin, /opt/homebrew/bin, and /usr/local/bin.

Configure a Finder launch

A Finder-launched app may not inherit terminal exports. Create ~/.config/skryba/env:

BRAMA_TOKEN=replace-me
SAPLING_API_KEY=replace-me
RENTAHUMAN_API_KEY=replace-me

Only include domains you use. Existing launch-environment variables win over this file.

Build and install

./Scripts/build-app.sh

The script builds a release executable, assembles and signs Skryba.app, verifies the signature, installs to ~/Applications/Skryba.app by default, and registers it with Launch Services. SKRYBA_INSTALL_APP_PATH overrides the install destination; SKRYBA_INSTALL_AFTER_BUILD=no stops after building and signing.

The completed source build evidence for this corpus was:

[35/37] Linking SkrybaDesktop
[36/37] Applying SkrybaDesktop
Build complete! (33.90s)

First workflow

1. Open Score in the sidebar.
2. Paste non-empty text.
3. Press Run.
4. Read the Command panel; Score sends the text on stdin.
5. Read ensemble AI probability, every detector row, and any cached labels.

With no detector credentials the CLI refusal appears verbatim:

Error: no detector credentials found; configure GPTZERO_API_KEY, WINSTON_API_KEY, ORIGINALITY_API_KEY, or SAPLING_API_KEY

That refusal confirms the spawn path works; configure a key before expecting a score.