CLI reference

The vitrine CLI does everything the interface does, from a terminal. It is available on the Pro and Studio plans.

Work in progress. This page lists the planned commands. Options and output formats will be documented in full as each command ships.

Sign in

vitrine login

Authenticates with a personal token, stored in your system keychain. Tokens can be revoked at any time.

Projects

vitrine pull --app jyva ./jyva.vitrine
vitrine push --app jyva ./jyva.vitrine [--dry-run]

pull downloads the project as JSON files and assets. push sends your edits back.

Render and check

vitrine render   --app jyva --page default --lang all
vitrine render   --app jyva --lang fr --force
vitrine coverage --app jyva [--format md|json] [--blocking]
vitrine board    --app jyva --page default --lang all

Rendering is incremental: only what changed is rendered again. coverage --blocking exits with a non-zero code when a blocking issue remains, which makes it usable in CI.

Strings and captures

vitrine strings export  --app jyva --missing --format csv > to-translate.csv
vitrine strings import  --app jyva translations.csv [--dry-run]
vitrine captures import --app jyva ./raw_shots
vitrine captures run    --app jyva --lang ja

App Store Connect

vitrine asc connect --issuer <uuid> --key-id <id> --p8 <path>
vitrine publish --app jyva --page default --lang all --dry-run
vitrine publish --app jyva --page default --lang all --changed-only
vitrine status  --app jyva [--watch] [--format json]

asc connect stores the key in your keychain and tests the connection. status reports the state of versions, screenshots and product pages.