desktop app

Claude Code Local (Project)

Connect this project’s Claude Code to the Neptrix local runtime. Install the desktop app, then use its Setup page; the app writes the hook configuration and manages the runtime. No API key.

Neptrix desktop app required

This setup uses the Neptrix desktop app, which installs and manages the local runtime. Download the beta for macOS or Windows.

Installation

1Download and install the Neptrix desktop app for macOS or Windows from the download page.
2Open the app and follow the Setup page to connect Claude Code for this project. The app writes the hook configuration shown below into .claude/settings.json and manages the runtime for you.
3Restart Claude Code so it loads the hook. Tool calls in this project are now evaluated and recorded by the local runtime; this beta runs in monitoring mode, so nothing is blocked. The hook fails closed if the runtime is not running.
4Inspect the signed audit chain any time with: neptrix-runtime view --config ~/.neptrix/runtime.json --verify

Advanced: manual hook configuration

The desktop app's Setup page writes this configuration for you. Use the manual route only if you want to wire the hook yourself.

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 is needed. The desktop app manages the local runtime, and the hook talks to it over a socket. Download the desktop beta.

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.

Get the desktop beta.

Download the Neptrix desktop app for macOS or Windows and connect Claude Code from the Setup page.

Download the beta