local hook

Claude Code Local (Global)

Wire every Claude Code session on your machine to the Neptrix local runtime. Configure once in ~/.claude/settings.json and all projects route through on-device governance - no API key.

Neptrix local runtime required (coming soon)

This setup runs entirely on your machine. The local runtime binary is not published yet. Join the waitlist for early access.

Installation

1Install and start the Neptrix local runtime and bridge daemon. The runtime binary is not published yet, so join the waitlist for early access.coming soon
2Open or create ~/.claude/settings.json in your home directory
3Paste the configuration below. The PreToolUse hook runs client.js for every tool call (matcher ".*", timeout 105) and forwards it to the local bridge daemon over NEPTRIX_BRIDGE_DAEMON_SOCKET. No API key.
4Restart Claude Code. Every tool call across all projects now asks the local runtime, which fails closed if the runtime is not running.
5Inspect the signed audit chain any time with: neptrix-runtime view --config ~/.neptrix/runtime.json --verify

Add this configuration to~/.claude/settings.json

~/.claude/settings.json

1{
2  "env": {
3    "NEPTRIX_BRIDGE_DAEMON_SOCKET": "$HOME/.neptrix/bridge-daemon.sock"
4  },
5  "hooks": {
6    "PreToolUse": [
7      {
8        "matcher": ".*",
9        "hooks": [
10          {
11            "type": "command",
12            "command": "node $HOME/.neptrix/bin/client.js",
13            "timeout": 105
14          }
15        ]
16      }
17    ]
18  }
19}

No API key needed. The hook talks to the local runtime over a socket, and nothing leaves your machine. Join the waitlist for the runtime.

How it works

Agent proposes action

Before each tool call, your agent sends the proposed action to Neptrix for evaluation.

Neptrix evaluates

Constitutional governance rules evaluate the action. The decision is logged to your audit trail.

Decision returned

ALLOW, BLOCK, ESCALATE, or MODIFY. Agents auto-discover — no registration needed.

Run governance on your own machine.

The Neptrix local runtime keeps every decision on-device. Join the waitlist to get it the moment it ships.

Join the waitlist