AI-aware developer intelligence from the command line

Install · What it does · Commands · Docs

---

Vreko watches what your AI tools do, learns your codebase's fragile zones, and surfaces the right context before problems occur. The CLI is the primary interface to the local Vreko daemon (vrekod).

Install

npm install -g @vreko/cli

Shorthand: vr --help

What it does

• Starts and manages the local Vreko daemon
• Surfaces codebase intelligence from the terminal
• Exposes session snapshots, risk scores, and pattern learnings
• Bridges to MCP-compatible AI tools via vreko_pulse
• Generates .agents/workspace.json and AGENTS.md for AI agent consumption

Intelligence, not just recovery

Vreko learns from what breaks — secrets overwritten, phantom dependencies introduced, config files mangled by AI tools. Over time it knows your codebase's specific fragile zones and predicts problems before they occur. Recovery is instant when you need it. The goal is you rarely do.

Design properties

• Local-first. Analysis runs against the local daemon; there is no requirement to send repository contents to a remote service to use the CLI.
• Detection is heuristic. AI-attributed change detection across Cursor, Copilot and Claude Code is a heuristic over edit timing and shape. It is not exact, and no accuracy figure is published because no reproducible benchmark has been published to support one.
• Optional cloud. Authentication and sync are opt-in; vr status reports which mode you are in.

Run vr doctor for the diagnostics this build actually reports about your machine.

Commands

Command	Purpose
vr init	Initialize Vreko in the current workspace
vr status	Health check — vitals, session state, detected issues
vr check	Pre-commit risk scan on staged files
vr snapshot	Create, list, or restore snapshots
vr context	Pre-task intelligence briefing
vr learn	Capture a mid-session insight
vr pulse	Mid-session intelligence snapshot
vr patterns	Show learned patterns
vr doctor	Diagnostic checks and self-healing
vr mcp	Start/configure the MCP server
vr start / vr stop	Control the vrekod daemon

MCP Integration

The CLI bundles the Vreko MCP server. Add to your AI assistant's config:

{
  "mcpServers": {
    "vreko": {
      "command": "npx",
      "args": ["-y", "@vreko/cli", "mcp", "--stdio", "--workspace", "/absolute/path/to/your/project"]
    }
  }
}

Global Flags

--verbose / VREKO_VERBOSE   Verbose output
--debug / VREKO_DEBUG       Debug mode (implies --verbose)
--json / VREKO_JSON         JSON output for scripts and LLMs
--plain / VREKO_PLAIN       Disable TUI — plain text for CI/automation
-q, --quiet                 Suppress non-essential output
-y, --yes                   Skip confirmation prompts

Docs

docs.vreko.dev/cli

What this repository contains

This repository is the public distribution and documentation surface for @vreko/cli. The CLI is built from the proprietary Vreko core, so the implementation is not published here — this repository carries the package manifest, changelog, license and documentation that ship with the release.

Installable artifacts are on npm: @vreko/cli. What the CLI does at the protocol boundary is inspectable in vreko-dev/mcp-server.

License

Apache-2.0. Copyright 2026 Vreko, Inc.