What is Skryba Desktop?

Skryba Desktop is a native macOS workspace for three installed-CLI workflows: score text, rewrite text, and inspect one RentAHuman humanization. It is a process client, not a second Skryba implementation.

Mental model: one workflow, one process

Every press of Run validates the visible form, resolves an executable named skryba, and starts one process with one argv and optional stdin. The app shows the exact command. It captures stdout, stderr, and exit status after draining both pipes concurrently.

Mental model: typed view over CLI JSON

Successful Score and Rewrite stdout are decoded into Swift mirrors whose coding keys match the CLI's serde fields. The UI renders useful fields, but the CLI remains the source of scoring and selection. RentAHuman Status deliberately displays the CLI's stdout verbatim because the remote API's JSON is the record.

A nonzero status is not reinterpreted. The danger panel title is skryba refused the workflow, and its detail is stderr verbatim (or skryba exited with status <n>. when stderr is empty).

Mental model: credentials stay below the view

The app inherits its launch environment and fills only missing variables from ~/.config/skryba/env. That merged environment is passed to the CLI process. The UI has no credential fields and owns no model routing, detector adapter, cache, rate limit, quality judge, policy, or RentAHuman protocol.

Surface

• Score
• Rewrite
• RentAHuman Status
• Spawn contract
• Configuration
• Runbook