Cursor Integration

Intracept + Cursor

Every command Cursor's agent runs — translated to plain English, evaluated against your policy, with approval dialogs right in the editor.

01

Hook intercepts

Cursor fires a beforeShellExecution hook before every shell command. Intracept's compiled Rust binary catches it in under a millisecond.

02

Translate + evaluate

The command is pattern-matched and translated to plain English. Your policy decides the verdict: allow, require approval, or deny.

03

Approve in-editor

Safe commands run silently with a status bar translation. Risky commands show a Quick Pick dialog at the top of your editor — approve or deny with one click.

What you see

❯i

Quick Pick approval dialog

require_approval

When a command needs approval, a Quick Pick appears at the top of Cursor showing the plain-English translation. Click Approve to proceed or Deny to block it.

Quick Pick:
❯i Delete the /tmp/build directory recursively
ApproveDeny
❯i

Status bar translation

allow

Every allowed command shows a colored translation in the status bar at the bottom of Cursor. Green for allowed, amber for approval-required. No interruption to your flow.

❯iallow|Run the full test suite
❯i

Toast notifications

A brief notification appears in the corner of Cursor showing the translation and verdict. Auto-dismisses after 8 seconds for allowed commands.

Setup

Up and running in under a minute.

1

Install Intracept

Install via Homebrew or build from source.

$ brew tap laurenalexander2/tap
$ brew install --cask intracept

Or: curl -fsSL https://intracept.dev/install.sh | sh

2

Register with Cursor

This writes the hook config to ~/.cursor/hooks.json and installs the extension.

$ intracept install --agent cursor
3

Start the daemon

The daemon runs in the background and handles translation + policy evaluation.

$ intracept start
4

Use Cursor normally

That's it. Every shell command Cursor's agent runs now passes through Intracept. You'll see translations in the status bar and approval dialogs for risky commands.

Intracept is active

What gets installed

~/.cursor/hooks.jsonbeforeShellExecution hook pointing to the intracept-hook binary
~/.intracept/bin/intracept-hookCompiled Rust binary that intercepts commands (< 1 MB)
~/.intracept/policy.yamlYour policy rules — edit anytime, changes apply immediately
~/.intracept/intracept.dbSQLite audit log of every command and decision

To uninstall: intracept uninstall --agent cursor