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.

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