Everyday commands

The small ones you actually type between the big ones — checking the machine, seeing where a session stands, opening the board, and keeping the repo tidy.

doctor

Reports what this machine can and cannot do, and why. Each failing check names the exact command that repairs it, rather than telling you something is wrong and leaving you to find out what.

vitrinka doctor

It never prompts, and it never touches your token or operator persona.

status

The session dashboard: the live board, the open work queue, and the listener lease.

vitrinka status --live

Flag	What it does
`--live`	Repaint every few seconds on a terminal. Ctrl-C exits.
`--project`	Project name. Defaults to this repository.
`--branch`	Branch. Defaults to the current one.
`--root`	Capture root. Default `.vitrinka/screenshots`.

open

Opens the capture root's live board when a set exists, otherwise vitrinka home. The QR mode is for getting a board onto a tablet without typing a URL.

vitrinka open
vitrinka open --qr      # scan with an iPad, annotate with the Pencil
vitrinka open --print   # just print the URL

Flag	What it does
`--qr`	Render the URL as a terminal QR code instead of opening it.
`--print`	Print the URL only.
`--browser`	Force the https URL even when Vitrinka.app is installed.

edit

Focuses the resident Vitrinka.app on a file or project, and records the repo in the project registry so the app's project list stays current.

vitrinka edit .
vitrinka edit --print   # print the deep link only

tidy

Plans moves of legacy capture roots and loose screenshot litter into .vitrinka/. It only plans until you pass --yes.

vitrinka tidy          # plan
vitrinka tidy --yes    # apply

Flag	What it does
`--yes`	Apply the planned moves.
`--all`	Also move loose images and audit files, not just `shot-*.png` litter.

Git-tracked paths are never touched.

ai

Translates a plain-language request into one vitrinka command through a local claude -p call, shows it to you, and runs it only after you agree.

vitrinka ai "show me open work on this branch"

The suggestion is validated against the real command tree and is never shell-evaluated. VITRINKA_NO_AI=1 disables the whole thing.

update and uninstall

update refreshes the CLI through whichever channel installed it — package manager, git checkout or release artifact — and then the agent plugins.

vitrinka update
vitrinka uninstall --yes
vitrinka uninstall --purge --yes   # also removes token + operator

`update` never asks new consent questions — that is install's job.
`uninstall` leaves credentials alone — the token and operator persona survive unless you pass --purge — credentials are not installation.
`--local` — project scope: legacy copies under ./.claude, project-scope MCP first.

Everyday commands

#doctor

#status

#open

#edit

#tidy

#ai