On this page

What is Skryba Desktop?

Skryba Desktop is a native macOS workspace for four installed-CLI workflows: score text, rewrite text, hold the writing style of the person using it, and manage the styles and output languages a rewrite can require. It is a process client, not a second Skryba implementation. Paying a person to rewrite text is HandToHuman's job and runs on the handtohuman market CLI, not here.

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, Rewrite, Writing style, and Styles & languages 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. The app keeps no list of styles or languages: the Rewrite pickers offer what the CLI's catalog listed.

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, or policy. Writing style and Styles & languages need no credential at all: the CLI subtrees they spawn call neither Brama nor a detector.

Surface

Maintained as part of the website-owned Skryba documentation corpus.