@alexeiled/claude-router 0.1.0

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@alexeiled/claude-router",
+  "version": "0.1.0",
+  "description": "Claude Code plugin: a local gateway that selects a model and an effort level for each user turn with a TypeSafe Jev Choice.",
+  "license": "MIT",
+  "author": "Alexei Ledenev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alexei-led/claude-router.git"
+  },
+  "homepage": "https://github.com/alexei-led/claude-router#readme",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    ".claude-plugin/plugin.json",
+    "hooks",
+    "lib",
+    "scripts",
+    "skills",
+    "docs",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test --test-timeout=8000 test/*.test.mjs",
+    "check": "biome check .",
+    "validate": "claude plugin validate .",
+    "format": "biome format --write .",
+    "pack:dry": "npm pack --dry-run",
+    "prepublishOnly": "npm run check && npm test"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.14"
+  }
+}

package/scripts/ensure-gateway.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+// SessionStart hook: start the gateway daemon when nothing answers on its port. Detached, so it outlives the session.
+import { spawn } from 'node:child_process';
+import { mkdirSync, openSync } from 'node:fs';
+import { connect } from 'node:net';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadRuntime } from '../lib/runtime.mjs';
+
+const env = process.env;
+const { config, dataDir } = loadRuntime(env);
+const port = config.gateway.port;
+
+function probe() {
+  return new Promise((resolve) => {
+    const socket = connect({ host: '127.0.0.1', port });
+    socket.once('connect', () => {
+      socket.destroy();
+      resolve(true);
+    });
+    socket.once('error', () => resolve(false));
+  });
+}
+
+const configured = (env.ANTHROPIC_BASE_URL ?? '').includes(`127.0.0.1:${port}`);
+if (!configured)
+  process.stdout.write(
+    'router: Claude Code does not use the gateway yet. Run /router:setup, then restart Claude Code.\n',
+  );
+
+if (!(await probe())) {
+  mkdirSync(dataDir, { recursive: true });
+  const log = openSync(join(dataDir, 'gateway.log'), 'a');
+  // Claude Code exports the plugin option as CLAUDE_PLUGIN_OPTION_<KEY>; the gateway reads one name only.
+  const childEnv = {
+    ...env,
+    TYPESAFE_API_KEY: env.TYPESAFE_API_KEY || env.CLAUDE_PLUGIN_OPTION_TYPESAFE_API_KEY || '',
+  };
+  const child = spawn(process.execPath, [join(dirname(fileURLToPath(import.meta.url)), 'gateway.mjs')], {
+    detached: true,
+    stdio: ['ignore', log, log],
+    env: childEnv,
+  });
+  child.unref();
+  // Wait for the listener so the session's first request finds it.
+  let up = false;
+  for (let i = 0; i < 20 && !up; i += 1) {
+    await new Promise((r) => setTimeout(r, 100));
+    up = await probe();
+  }
+  process.stdout.write(
+    `router: gateway on 127.0.0.1:${port} ${up ? 'started' : 'not answering yet'} (pid ${child.pid})\n`,
+  );
+}
+process.exit(0);

package/scripts/gateway.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// Daemon entry: local gateway on 127.0.0.1:<gateway.port>. Started by the SessionStart hook or by hand.
+import { createGateway } from '../lib/gateway.mjs';
+import { Router } from '../lib/router.mjs';
+import { loadRuntime } from '../lib/runtime.mjs';
+
+const { config, dataDir } = loadRuntime(process.env);
+const router = new Router({ config, fetchFn: globalThis.fetch, dataDir });
+const server = createGateway({ router, onError: (error) => process.stderr.write(`router: ${error.message}\n`) });
+server.listen(config.gateway.port, '127.0.0.1', () =>
+  process.stdout.write(`router: listening on http://127.0.0.1:${config.gateway.port} as ${config.gateway.alias}\n`),
+);

package/scripts/transcript-models.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+# Print model, session effort, per-turn effort, active skill and block types per assistant line.
+# Usage: spike-check.sh ~/.claude/projects/<project>/<session>.jsonl
+jq -r 'select(.type=="assistant") | [.timestamp[11:19], .message.model, (.effort // "-"), (.perTurnEffort // "-"), (.attributionSkill // "-"), ([.message.content[]?.type] | join(","))] | @tsv' "$1"

package/skills/high/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: high
+disable-model-invocation: true
+description: Manual pin: run this turn on fable at xhigh effort. Use as /router:high <prompt>.
+model: fable
+effort: xhigh
+---
+Routing tier applied. Continue with the user's request as written. Do not mention the router.

package/skills/low/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: low
+disable-model-invocation: true
+description: Manual pin: run this turn on sonnet. Use as /router:low <prompt>.
+model: sonnet
+---
+Routing tier applied. Continue with the user's request as written. Do not mention the router.

package/skills/medium/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: medium
+disable-model-invocation: true
+description: Manual pin: run this turn on opus at high effort. Use as /router:medium <prompt>.
+model: opus
+effort: high
+---
+Routing tier applied. Continue with the user's request as written. Do not mention the router.

package/skills/micro/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: micro
+disable-model-invocation: true
+description: Manual pin: run this turn on haiku. Use as /router:micro <prompt>.
+model: haiku
+---
+Routing tier applied. Continue with the user's request as written. Do not mention the router.

package/skills/setup/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: setup
+description: Point Claude Code at the router gateway. Adds `model` and `ANTHROPIC_BASE_URL` to the user settings.
+disable-model-invocation: true
+allowed-tools: Read, Edit, Write
+---
+Configure Claude Code for the router gateway. Do these steps:
+
+1. Read `~/.claude/settings.json`. If the file does not exist, start from `{}`.
+2. Set the key `model` to `"router"`.
+3. Set the key `env.ANTHROPIC_BASE_URL` to `"http://127.0.0.1:43170"`. If `~/.claude/router.json` sets `gateway.port`, use that port.
+4. Keep every other key unchanged. Write the file.
+5. Tell the user: restart Claude Code, then the router serves each turn. To stop the routing, remove the two keys.
+
+Do not change any other file.