@highflame/overwatch
v2.0.11
Published
IDE-agnostic security daemon for AI coding assistants. Evaluates prompts, tool calls, file operations, shell commands, and MCP usage in real time for Cursor, Claude Code, GitHub Copilot, Gemini CLI, and OpenAI Codex.
Readme
Overwatch
Overwatch is a lightweight, IDE-agnostic security daemon for AI coding assistants. It attaches to your IDE's native hook system and evaluates every prompt, tool call, file operation, shell command, and MCP interaction in real time, forwarding events to the Highflame Cerberus service for threat detection and policy enforcement.
It runs on the developer's machine, alongside the IDE rather than in the network path. There are no proxies, no certificates, and no added latency. Activity flows into Highflame Studio for organization-wide discovery, threat monitoring, and audit.
Works with Cursor, Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and more.
Installation
npm install -g @highflame/overwatchThe matching native scanner binary is installed automatically for your platform via optional dependencies (macOS, Linux, and Windows on both x64 and ARM64).
Quick Start
# Start the daemon (opens a browser to authenticate with Highflame Studio on first run)
overwatch start
# Confirm it's running and see which IDEs it attached to
overwatch status
# (Optional) Auto-start on boot
overwatch install-serviceOn first run, Overwatch authenticates with Highflame Studio, detects every supported coding assistant on your machine, and attaches hooks to each one. You don't need to restart your IDE or reconfigure your assistant.
For the full step-by-step setup, alternative install paths (script, Windows native, Claude Code plugin, Copilot, Tailscale), and policy configuration, follow the Installation Guide.
Common Commands
| Command | What it does |
| --- | --- |
| overwatch start | Start the daemon; authenticate and install hooks for any detected IDE |
| overwatch stop | Stop the daemon |
| overwatch restart | Restart (useful after an upgrade) |
| overwatch status | Show daemon health, event count, auth status, and installed hooks |
| overwatch install <ide> | Install hooks for a specific IDE (cursor, claudecode, github_copilot, gemini_cli, openai_codex) |
| overwatch scan | Scan the MCP servers configured in your IDEs for security issues |
| overwatch whoami | Show the authenticated user, organization, and session expiry |
Run overwatch --help for the full list.
Requirements
- Node.js 18 or newer
- A supported coding assistant (Cursor, Claude Code, GitHub Copilot, Gemini CLI, or OpenAI Codex)
Documentation
- Installation Guide — get Overwatch running on developer workstations
- Code Agents Overview — what the Code Agent Control Plane is and who it's for
- Code Agent Policies — define the guardrails Overwatch enforces
- Discovery and Metrics — see what's running across your organization
License
MIT
