Get Started with Vreko
Install the Vreko CLI:
npm install -g @vreko/cliInitialize in your project:
cd your-project
vreko initVreko is now watching your codebase. Run your next AI prompt — Vreko is already informing the context.
What just happened
Vreko detected your agent setup automatically. A pointer to .vreko/docs/INTELLIGENCE.md has been added to your CLAUDE.md, .cursorrules, or project instructions file — that’s what your agent reads on every prompt now.
It’s probably short right now. Vreko is still learning your codebase. Over the next few weeks it will surface fragile files, AI drift zones, and co-change patterns specific to your code.
If the block is empty or missing after a few sessions, run vreko status to verify the service is running.
Optional: VS Code Extension
Want ambient signals in your editor? The extension adds status bar indicators and file decorations.
The extension is optional — the CLI alone gives you the full intelligence layer and automatic agent delivery.
What to Expect
| When | What’s Happening |
|---|---|
| Right away | Vreko detects your agent setup and starts writing intelligence into your rules file |
| First week | AI-attributed changes above the risk threshold are snapshotted; Vreko starts building a picture of your codebase |
| Day 30 | Patterns emerge. Vreko starts knowing your codebase, not just watching it |
| Day 90 | Your agent sees fragile files before it touches them — delivered automatically on every prompt |
Advanced Integrations
Once your agent is seeing Vreko’s intelligence via rules-file delivery, you can add:
- Pre-tool-use hooks — Claude Code and emerging tools intercept tool calls before they execute
- MCP — for Claude Desktop and other MCP-native clients
- CLI in agent harnesses —
vreko contextfor custom orchestration
# Configure MCP for Claude Desktop
vreko mcp configure --tool claude-code
# Configure for Cursor
vreko mcp configure --tool cursorWhere to Go Next
- Architecture — What Vreko actually detects and why
- Integrations — All delivery mechanisms, ordered by ambient-ness
- CLI Reference — Full command reference
- Pioneer Program — Beta benefits and community perks