NeptrixNeptrix
shell hook

Cursor

Drop a shell hook script into .cursor/hooks/ and point Cursor at it. Every AI action gets evaluated before it runs.

需要 API 密钥

您需要 Neptrix API 密钥才能完成此设置。API 密钥随托管测试版访问权限一同发放，托管平台目前处于封闭测试阶段。 加入等待名单以获取访问权限。

安装

  1. 1Copy the script below
  2. 2Save it as .cursor/hooks/pre-tool-use.sh in your project
  3. 3Run: chmod +x .cursor/hooks/pre-tool-use.sh
  4. 4Replace YOUR_API_KEY with your key
  5. 5Configure Cursor to use the hook script in Settings > AI > Hooks
将此配置添加到.cursor/hooks/pre-tool-use.sh
.cursor/hooks/pre-tool-use.sh
1#!/bin/sh
2# Neptrix governance hook for Cursor
3# Save this as .cursor/hooks/pre-tool-use.sh and make it executable
4# Fails closed: if Neptrix is unreachable the action is denied.
5# Set NEPTRIX_FAIL_MODE=open to proceed ungoverned instead (not recommended).
6
7r=$(curl -sf --max-time 5 -X POST https://qpthort-backend-production.up.railway.app/hooks/claude-code/pre-tool-use -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" --data-binary @-) && { printf "%s" "$r"; exit 0; }; [ "$NEPTRIX_FAIL_MODE" = "open" ] && { echo "[Neptrix] WARNING: governance service unreachable and NEPTRIX_FAIL_MODE=open - tool call proceeding UNGOVERNED. Unset NEPTRIX_FAIL_MODE to restore fail-closed." >&2; exit 0; }; echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"[Neptrix] Governance service unreachable - action denied. Set NEPTRIX_FAIL_MODE=open to override."}}'

将 YOUR_API_KEY 替换为您的 API 密钥。 加入等待名单以获取托管访问权限。

工作原理

1

智能体提议操作

在每次工具调用之前，您的智能体将提议的操作发送给 Neptrix 进行评估。

2

Neptrix 进行评估

宪法治理规则评估操作。决策被记录到您的审计追踪中。

3

返回决策

ALLOW、BLOCK、ESCALATE 或 MODIFY。智能体自动发现——无需注册。

托管平台目前处于封闭测试阶段。

加入等待名单，在重新开放时优先获得访问权限，或立即下载桌面测试版，在您自己的机器上治理智能体。

下载桌面测试版加入等待名单