Installing the CLI
One npm install and one command. vitrinka install prints what is already set up, silently installs the reversible pieces, and asks before touching config.
Install
The reversible pieces — plugins, the shim, PATH and shell completion — are installed without asking. The things that change your configuration are not: MCP registrations, the write token and the operator persona are all prompted for.
npm i -g @lovinka/vitrinka
vitrinka installInstall flags
| Flag | What it does |
|---|---|
--yes | Never prompt — behaves exactly like a non-TTY run. |
--local | Project scope: no shim or completion, project-scoped MCP, no global Codex registry writes. |
--mcp / --no-mcp | Register or skip the MCP endpoints without asking. |
--extension / --no-extension | Install or skip the journey-recorder extension. |
--no-completion | Skip shell completion. |
--operator | Set the board-attribution operator persona. |
--base | Deployment URL — overrides $VITRINKA_URL and the stored default. |
A non-interactive run skips every prompt and prints the manual command instead, so nothing is silently decided for you in CI.
Check and repair
doctor checks this machine's setup and names the repair for each failure rather than only reporting that something is wrong.
vitrinka doctor
vitrinka update # CLI + every installed surface
vitrinka uninstall # remove everything install put here