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.

Proof stack

• 94% AI detection accuracy across Cursor, Copilot, and Claude Code
• <50ms overhead — zero-friction protection
• <1s context injection — full intelligence loaded instantly
• Code never leaves your machine — local-first, privacy-first

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

License

Apache-2.0