vitrinka.docs

Developer

Connect your repo, CLI and agent.

Three ways in

Everything a developer touches goes through one of three surfaces, all speaking to the same server: the vitrinka CLI on your machine, the MCP endpoint your agent connects to directly over HTTP (/mcp, OAuth), and the plain HTTP API underneath both. The skills teach an agent the workflows so it arrives knowing what a board is and what to do with one. The exact lists — every verb, tool, variable and card kind — live in the generated Reference tab; the pages here tell you how to use them.

The CLI

One npm install (@vitrinka/cli) for macOS, Linux and Windows, one binary, one vitrinka setup that sets the rest up.

PageWhat it covers
Installing the CLInpm i -g @vitrinka/cli, what vitrinka setup sets up, check and repair.
The commandsA tour of the nouns — board, work, task, sprint, intake, qa, me, review, search, project, config, setup — with --base, --json, --no-input and --yes throughout.
Sets: capture and publishA set is a directory of files with a share URL; how one gets made, filled, checked and sent, documents and pages included.
Boards, tags and diagramsTurning a set into the surface people actually mark up, opening and sharing it, and keeping it findable.
The work queueHow a machine reads released annotations, how an agent session holds the queue, and where the session stands.
Machine and repo setupCredentials per deployment, bindings per repository, the operator persona, the committed repo file, hooks and commit trailers.
Todos, reminders and timevitrinka me — todos that ripen on a condition the server evaluates, reminders, milestones and automatic work time.

Agents

PageWhat it covers
SkillsNineteen skills in four plugins — core, PM, QA and the opt-in experimental one — for Claude Code and Codex.
Capture and publishGetting work onto a board — screens as they are built, journeys, reports.
Working the queuePicking up annotations, fixing them in the repo, closing the loop with proof.
Sessions to shipped fixesRecorded user-testing sessions into changed code and maintained tests.
AuthoringDocumentation, architecture, pages and design decisions — the skills that write.
Running the projectThe task engine, the release and the work loop from the repository.
Workflowsmake-idea and cleanup — the plugin's unattended Claude Code workflows, from an idea to an opened PR and from a backlog to a clean one.
Composing boardsHow an agent composes one batch per coherent unit, anchored by relation, and how the server owns the layout.
MCP for any clientRegistering the deploy's /mcp endpoint with Claude Code, Codex, Cursor, OpenCode, VS Code, Gemini CLI or any OAuth-capable MCP host.
MCP tool referenceEvery tool the MCP endpoint serves.

Live loops and the raw wire

PageWhat it covers
Live pairingvitrinka qa pair — fix while the tester keeps testing.
HTTP APIThe contract the CLI, the MCP endpoint and the recorders all speak, family by family, and the live event stream.

On this page