Initial commit

Supervised action bridge between Claude Code and the host system.
Server accepts structured action requests, applies per-action policies
(auto-accept/auto-deny/queue), and executes approved actions via typed
handlers. Client provides CLI and module interfaces for calling the API.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

README.md

@@ -0,0 +1,66 @@
+# claude-code-conduit
+
+A supervised action bridge between Claude Code and the host system.
+
+Claude requests structured actions. The server applies per-action policies:
+- **auto-accept** — executed immediately (e.g. open a file in editor)
+- **auto-deny** — rejected immediately
+- **queue** — held for user approval (e.g. open a browser URL)
+
+## Setup
+
+```bash
+npm install
+```
+
+## Running the server
+
+```bash
+node server/index.js
+# or
+CONDUIT_PORT=3333 CONDUIT_ROOT=/workspace node server/index.js
+```
+
+## Using the CLI client
+
+```bash
+# List available actions
+node client/index.js list-actions
+
+# Open a file in the editor (auto-accepted)
+node client/index.js edit-file filename=/workspace/myfile.js
+
+# Open a URL (queued for user approval)
+node client/index.js open-browser url=https://example.com
+```
+
+When a queued action is submitted, the server prints the approve/deny URLs to stdout:
+
+```
+[QUEUE] New request #a1b2c3d4
+  Action: open-browser
+  Params: {"url":"https://example.com"}
+  Approve: POST /queue/a1b2c3d4.../approve
+  Deny:    POST /queue/a1b2c3d4.../deny
+```
+
+User approves via:
+```bash
+curl -X POST http://localhost:3333/queue/<id>/approve
+```
+
+## Environment variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `CONDUIT_PORT` | `3333` | Server port |
+| `CONDUIT_ROOT` | `/workspace` | Workspace root for path resolution |
+| `CONDUIT_URL` | `http://localhost:3333` | Server URL (client-side) |
+
+## Adding actions
+
+Edit `server/actions.js`. Each action needs:
+- `description` — shown in list-actions
+- `params` — array of `{ name, required, type }`
+- `policy` — `"auto-accept"` | `"auto-deny"` | `"queue"`
+- `handler(params, helpers)` — async function that performs the action