Your codebase gets smarter every session.
Pattern Memory learns what breaks YOUR code - mistakes don't repeat, patterns compound.
Quick Start · Platform · MCP Integration · Documentation · Discord
AI coding agents are powerful but unpredictable. Vibe-coding with Cursor, Claude Code, or Copilot ships features fast - and introduces regressions just as fast. Vreko turns that unpredictability into compound intelligence:
| Day 1 | Day 30 | Month 3 |
|---|---|---|
| Automatic snapshots | Learns YOUR patterns | Catches issues before they ship |
| AI change detection | Context-aware warnings | Team-wide pattern library |
| Real-time intelligence | Risk calibration | Mistakes don't repeat |
Your codebase gets smarter every session. Patterns compound. Mistakes don't repeat.
This extension is one piece of an integrated intelligence system. Each component amplifies the others:
| Component | What It Adds |
|---|---|
| 🦎 VS Code Extension | Visual interface, real-time snapshots, Pattern Memory feedback |
⌨️ CLI (@vreko/cli) |
Terminal workflows, CI/CD hooks, automation scripts |
| 🤖 MCP Server | AI assistant coordination, context-aware checkpoints, learning capture |
| 📊 Web Dashboard | Cross-project insights, team patterns, intelligence analytics |
Start here → Extension works standalone. Add CLI for terminal workflows. Add MCP to supercharge your AI assistant.
The intelligence layer that learns YOUR codebase. Day 1: snapshots. Day 30: it knows what breaks. Month 3: catches patterns you didn't know existed.
Access any previous state in <1 second. Compare, diff, learn from what changed.
Automatically detects changes from 11 AI assistants: GitHub Copilot, Cursor, Claude, Windsurf, Cline, Tabnine, Codeium, Amazon Q, JetBrains AI, Sourcegraph Cody, and more.
One-click access to session status, quick actions, stats, and web dashboard.
100% local by default. Your code never leaves your machine. Cloud sync is optional.
VS Code Marketplace (Recommended)
ext install MarcelleLabs.vreko-vscode
Or install from the marketplace
- Open any critical file (
.env,auth.ts,database.ts) - Right-click → Vreko: Protect This File
- Choose a protection level:
| Level | Icon | Behavior |
|---|---|---|
| Watch | 👁️ | Monitor silently, auto-snapshot on changes |
| Warn | Show banner before risky edits | |
| Block | 🔒 | Require confirmation for any edit |
When Vreko detects a risky change:
- You'll see a warning with context about why it's risky
- Compare the diff to understand what changed
- Accept or revert based on Pattern Memory's guidance
- Vreko learns from your decision
Shortcut: Cmd+Shift+S creates a snapshot, Cmd+Shift+R opens the timeline.
The Vreko status bar item gives you one-click access to everything:
┌─────────────────────────────────────┐
│ Vreko Quick Actions │
├─────────────────────────────────────┤
│ 📸 Create Snapshot │
│ 🧠 View Timeline │
│ 🛡️ Protect Current File │
│ 📊 Open Dashboard │
│ ⚙️ Settings │
└─────────────────────────────────────┘
Click the status bar → select an action → done. No command palette required.
Vreko includes a Model Context Protocol (MCP) server that enables AI assistants to coordinate with your intelligence system.
The extension includes proactive health monitoring to ensure your MCP server is always ready when AI assistants need it:
- Fast Detection: Know about issues in <5s (not 30s)
- Adaptive Polling: Faster checks when you're actively using AI tools
- Status Bar Indicator: Real-time health status with visual feedback
- Proactive Alerts: Toast notifications when MCP becomes unavailable
- Zero Surprise Failures: LLM tools never hit a dead server unexpectedly
Status Bar States:
| Icon | Color | Meaning |
|---|---|---|
| ✓ | Green | MCP healthy and ready |
| ⚠ | Yellow | MCP degraded (slower than usual) |
| ✗ | Red | MCP unavailable |
| ? | Gray | MCP status unknown |
Configuration:
{
"vreko.mcp.healthGuardian.enabled": true,
"vreko.mcp.healthGuardian.proactiveAlerts": true
}Vreko exposes a 4-tool session API designed for agentic coding loops. Your AI assistant calls these automatically:
vreko({ task: "refactor auth module" })
→ briefing: past learnings, active warnings, lineage chain
[... agent works with full context ...]
vreko_pulse() // optional mid-session vitals check
→ pulse: elevated, pressure: 38%, trajectory: stable
vreko_learn({ insight: "always snapshot before token refresh logic" })
vreko_end({ outcome: "completed", summary: "..." })
→ ceremony: files changed, patterns captured, carry-forward context
| Tool | When | Purpose |
|---|---|---|
vreko |
Start of every task | Opens session, returns intelligence briefing |
vreko_pulse |
Mid-session check | Read-only vitals: pulse, pressure, trajectory |
vreko_learn |
Any discovery | Captures pattern, gotcha, or decision |
vreko_end |
Task complete | Closes session with ceremony and carry-forward context |
The full surface - check, advise, safe_to_write, refactoring and learning intelligence tools - is also available. See MCP documentation →
Add to your AI assistant's MCP configuration:
{
"mcpServers": {
"vreko": {
"command": "npx",
"args": ["-y", "@vreko/cli", "mcp", "--stdio", "--workspace", "/absolute/path/to/your/project"],
"env": {
"VREKO_API_KEY": "your-api-key-here"
}
}
}
}For terminal workflows and automation, install the Vreko CLI:
npm install -g @vreko/cli
# or
pnpm add -g @vreko/cli# Create a snapshot before risky operations
vreko "before refactor"
# List recent snapshots
vreko list
# Check file against learned patterns
vreko check src/auth.ts
# View intelligence status
vreko status
# Compare current state with a snapshot
vreko diff <snapshot-id>The CLI shares the same .vreko/ database as the extension - your snapshots and learnings sync automatically.
| Command | Shortcut | Description |
|---|---|---|
| Create Snapshot | Cmd+Shift+S |
Snapshot current file state |
| View Timeline | Cmd+Shift+R |
Browse snapshot history with diffs |
| Compare Changes | - | See what AI changed and why |
| View All Snapshots | - | Full snapshot history |
| Command | Description |
|---|---|
| Protect File | Add file to protection with level selection |
| Protect Entire Repo | Auto-protect based on patterns |
| Change Protection Level | Adjust Watch/Warn/Block |
| View Protected Files | See all protected files |
| Command | Description |
|---|---|
| Browse Session | View all changes from a session |
| Compare with Snapshot | Diff current vs snapshot |
| Delete Older Snapshots | Clean up old snapshots |
Access all commands: Cmd+Shift+P → type "Vreko"
Vreko works 100% offline with full functionality. Sign in to unlock cloud features.
Cmd+Shift+P→ Vreko: Sign In- Browser opens → Sign in with GitHub or Google
- Extension auto-connects
| Feature | Local | Cloud |
|---|---|---|
| Snapshots | ✅ Unlimited | ✅ + Sync |
| AI Detection | ✅ 11 tools | ✅ Same |
| Pattern Learning | ✅ Local patterns | ✅ + Community patterns |
| Cross-device | ❌ | ✅ Yes |
| Team sharing | ❌ | ✅ Yes |
Cmd+Shift+P → Vreko: Sign Out - all local data preserved.
Create .vrekorc in your workspace root:
{
"protection": {
"patterns": {
"*.env*": "block",
"src/auth/**": "warn",
"**/database/**": "watch"
}
},
"snapshots": {
"autoCreate": true,
"maxAge": "30d"
}
}{
"vreko.autoProtect": true,
"vreko.protectionPatterns": ["*.env*", "**/*.key"],
"vreko.telemetry": false
}Full configuration reference →
- Local-first: All data in
.vreko/in your workspace - No telemetry without explicit consent
- No code upload: We never see your code
- Open source: Audit at github.com/vreko-dev
- Cloud optional: Full functionality offline
- Requires VS Code 1.80+
Cmd+Shift+P→ "Developer: Reload Window"- Check Output panel → "Vreko" for errors
- Check
.vreko/directory exists in workspace - Verify file is protected: look for badge in explorer
- Confirm disk space available
- Verify MCP config syntax
- Check AI assistant supports MCP
- See MCP troubleshooting →
We're building Vreko in public and your feedback shapes the product.
- Discord: Join our community →
- GitHub Issues: Report bugs →
- Feature Requests: Discussions →
- Twitter: @vrekodev
| Resource | Link |
|---|---|
| Documentation | docs.vreko.dev |
| Website | vreko.dev |
| GitHub | github.com/vreko-dev |
| CLI | @vreko/cli |
| Changelog | View releases |
Built with 💚 by Marcelle Labs