OpsContext — AI Agent ComplianceProtocol Firewall + durable memory for AI coding agents. Your AI sessions end clean, not chaotic — OpsContext ensures agents save learnings, commit code, and update docs. Installation Launch VS Code Quick Open ( Ctrl+P), paste the following command, and press enter.Copied to clipboard |
OpsContext — VS Code ExtensionAI Agent Compliance. Persistent memory, enforcement nudges, and session management for AI coding agents.
WhyAI coding agents (Copilot, Claude, Cursor) are powerful but forgetful. They don't commit code, they don't save context, and they don't follow protocol. OpsContext won't make them perfect — but it adds the guardrails that make the difference between a productive session and a mess. Features🛡️ Git Status MonitorContinuous monitoring of uncommitted changes across all workspace projects. Status bar shows real-time count. Notifications fire when changes accumulate without commits. 💬 Chat Participant —
|
| Command | What it does |
|---|---|
@contextengine /status |
Session health dashboard — uncommitted files, project status |
@contextengine /commit fix: resolve login bug |
Stage + commit all changes with your message |
@contextengine /search deployment process |
Search the knowledge base |
@contextengine /remind |
Full enforcement checklist — what's missing before you end |
@contextengine /sync |
Check doc freshness per project — shows stale/missing docs |
(The chat handle stays @contextengine so your saved transcripts and muscle memory keep working.)
📊 Status Bar
Persistent indicator showing:
- ✅
CE— all clean - ⚠️
CE: 5— uncommitted files (yellow warning) - 🔴
CE: 12— critical, commit now (red alert)
Click for detailed breakdown with action buttons. (Status-bar text uses CE for compactness; the brand is OpsContext.)
ℹ️ Info Panel
Click the ℹ️ status bar icon for a WebView panel showing:
- What OpsContext monitors (7-item checklist with FREE/PRO badges)
- End-of-session protocol steps
- Doc Sync status
- Architecture overview
🔔 Smart Notifications
- Warning when uncommitted files exceed threshold (configurable)
- Escalating urgency — gentle at 5 files, urgent at 10+
- Doc staleness alerts — fires when code is committed but docs (copilot-instructions, SKILLS.md, SCORE.md) haven't been updated (15-min cooldown)
- Action buttons: "Commit All", "Show Status", "Run Sync"
- 5-minute cooldown between notifications (no spam)
🖥️ Terminal Watcher (v0.4.0, upgraded v0.6.2)
Monitors all terminal command completions via VS Code Shell Integration API:
- Smart classification: git, npm, build, deploy, test, database, python, ssh
- Credential redaction — passwords, tokens, API keys masked as
***in Output log - Stuck-pattern detection — alerts after 3+ consecutive same-type failures (e.g. "Agent appears stuck: 3× git failures (SIGINT/cancelled)")
- Comment filtering — shell comment lines (
# ...) silently ignored - Fires notifications on success/failure
- Auto-triggers git rescan after git commands
- 30-second cooldown per category (no notification flood)
🪝 Pre-Commit Hook (v0.4.0, upgraded v1.20.0)
Bundled at hooks/pre-commit — BLOCKS commits (exit 1) when code is staged but docs are stale (>4h) or missing. Agents ignore warnings — only hard blocks prevent compliance drift. Install:
cp hooks/pre-commit .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
⌨️ Commands
| Command | Description |
|---|---|
OpsContext: Commit All Changes |
Stage + commit across all workspace projects |
OpsContext: Show Session Status |
Detailed status in Output panel |
OpsContext: End Session Checklist |
Run end-of-session protocol |
OpsContext: Search Knowledge Base |
Search OpsContext knowledge |
OpsContext: Sync Docs |
Check doc freshness across all projects |
OpsContext: Generate HTML Score Report (PRO) |
Generate + open HTML AI-readiness report. Pre-flight PRO check; non-PRO users see an upgrade notification. |
Configuration
| Setting | Default | Description |
|---|---|---|
contextengine.gitCheckInterval |
120 |
Git scan interval in seconds |
contextengine.enableNotifications |
true |
Show notification warnings |
contextengine.enableStatusBar |
true |
Show status bar indicator |
contextengine.autoCommitReminder |
true |
Remind to commit when files accumulate |
contextengine.maxDirtyFilesBeforeWarning |
5 |
Uncommitted file threshold for warnings |
(Setting keys stay contextengine.* — your existing settings.json continues to work after the rebrand.)
How It Works
The extension delegates to the OpsContext MCP CLI for knowledge operations (search, sessions, learnings). Git operations use native git commands directly.
This separation means:
- Extension stays lightweight — no heavy dependencies (embeddings, BM25)
- Always works — git monitoring works even without the OpsContext CLI installed
- Full power when available — search, sessions, end-session checks when CLI is installed
Privacy
OpsContext runs 100% on your machine. No project data — code, learnings, sessions, git history, dependencies — is ever sent to an external server. The only network calls are license validation for PRO users (license key + machine ID hash). See the full privacy details.
Requirements
- VS Code 1.93+
- Git installed and available in PATH
- (Optional)
@compr/opscontext-mcpnpm package for search/session features
License & publisher
Source-available under BSL-1.1 (Business Source License) — see LICENSE. Not OSI-approved open source; converts to AGPL-3.0 on 2030-02-22.
© 2026 PROD LLC (operating brand of CSS LLC, Swiss company, incorporated 2005). Marketplace publisher ID css-llc = the legal-parent name (not a typo). Full publisher disclosure · yannick@compr.ch