Quick Start

Get Prisma AIRS scanning in Cursor in under 5 minutes.

1. Install

npm (recommended)

npm install -g @cdot65/prisma-airs-cursor-hooks

From source

git clone https://github.com/cdot65/prisma-airs-cursor-hooks.git
cd prisma-airs-cursor-hooks
npm install && npm run build

2. Set Your API Key

export PRISMA_AIRS_API_KEY=<your-x-pan-token>

3. Validate Connectivity

npm global install

prisma-airs-hooks validate-connection

From source

npm run validate-connection

You should see a successful scan result confirming your API key and endpoint work.

4. Install Hooks Globally

npm global install

prisma-airs-hooks install --global

From source

npm run install-hooks -- --global

5. Restart Cursor

Quit and reopen Cursor. Open Settings > Hooks to confirm all four core hooks appear (plus any optional hooks installed with --optional):

• beforeSubmitPrompt
• beforeMCPExecution
• postToolUse
• afterAgentResponse

6. Test It

Send a prompt in Cursor's AI chat. Check the execution log in Settings > Hooks to see the hooks fire.

To test blocking, try a prompt that triggers a detection (e.g., a toxic or injection prompt). If your AIRS profile has enforcement set to "block", you'll see:

Submission blocked by hook

With a detailed message explaining what was detected and why.

7. Review Scan Logs

npm global install

prisma-airs-hooks stats

From source

npm run stats

Shows scan totals, block rates, latency percentiles, and detection breakdowns.

What's Next?

• Configuration -- tune modes, enforcement, and profiles
• Detection Services -- what AIRS scans for
• Architecture -- how the hooks work internally