subconscious-cli 0.2.1 → 0.3.1

package/bin/registry.generated.json

@@ -1,7 +1,12 @@
 {
   "_generated": "Source of truth: agents/registry.json. Do not edit by hand.",
   "defaults": {
-    "model": "subconscious/tim-qwen3.6-27b",
+    "model": "subconscious/glm-5.2",
+    "models": [
+      "subconscious/glm-5.2",
+      "subconscious/tim-qwen3.6-27b",
+      "subconscious/deepseek-v4-flash-marathon"
+    ],
     "baseUrl": "https://api.subconscious.dev",
     "baseUrlV1": "https://api.subconscious.dev/v1",
     "keyPlaceholder": "your_key",
@@ -10,14 +15,15 @@
   "agents": [
     {
       "id": "claude-code",
+      "command": "claude",
       "exampleDir": "claude_code",
       "name": "Claude Code",
       "aliases": [
-        "claude",
+        "claude-code",
         "claudecode"
       ],
       "displayName": "Claude Code + Subconscious",
-      "description": "Run Claude Code on your hosted Subconscious model — no code changes, just env vars.",
+      "description": "Run Claude Code on your hosted Subconscious model with gateway env, context limits, and telemetry.",
       "framework": "Claude Code",
       "language": "shell",
       "category": "coding-agent",
@@ -35,24 +41,95 @@
         "win32": "powershell -ExecutionPolicy Bypass -Command \"irm https://claude.ai/install.ps1 | iex\"",
         "fallback": "npm i -g @anthropic-ai/claude-code"
       },
+      "runbook": {
+        "mode": "launch",
+        "script": "claude-code/run.sh",
+        "setupScript": "claude-code/install.sh",
+        "setupActions": [
+          "status",
+          "uninstall"
+        ]
+      },
       "launch": "claude",
       "env": {
         "ANTHROPIC_BASE_URL": "{baseUrl}",
         "ANTHROPIC_AUTH_TOKEN": "{apiKey}",
         "ANTHROPIC_MODEL": "{model}",
         "ANTHROPIC_SMALL_FAST_MODEL": "{model}",
-        "DISABLE_AUTO_COMPACT": "true"
+        "ANTHROPIC_DEFAULT_OPUS_MODEL": "subconscious/glm-5.2",
+        "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "subconscious/glm-5.2",
+        "ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION": "Subconscious default model",
+        "ANTHROPIC_DEFAULT_SONNET_MODEL": "subconscious/tim-qwen3.6-27b",
+        "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "subconscious/tim-qwen3.6-27b",
+        "ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION": "Subconscious TIM Qwen 3.6 27B",
+        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "subconscious/deepseek-v4-flash-marathon",
+        "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "subconscious/deepseek-v4-flash-marathon",
+        "ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION": "Subconscious DeepSeek V4 Flash Marathon",
+        "CLAUDE_CODE_SUBAGENT_MODEL": "{model}",
+        "CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS": "4",
+        "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "1",
+        "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
+        "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "3000000",
+        "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
+        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
+        "OTEL_LOGS_EXPORTER": "otlp",
+        "OTEL_EXPORTER_OTLP_PROTOCOL": "http/json",
+        "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "{baseUrl}/v1/logs",
+        "OTEL_EXPORTER_OTLP_HEADERS": "x-api-key={apiKey}",
+        "OTEL_EXPORTER_OTLP_TIMEOUT": "2000",
+        "OTEL_LOGS_EXPORT_INTERVAL": "2000"
+      }
+    },
+    {
+      "id": "codex",
+      "command": "codex",
+      "exampleDir": "codex",
+      "name": "Codex CLI",
+      "aliases": [],
+      "displayName": "Codex + Subconscious",
+      "description": "Run Codex on your hosted Subconscious model with a temporary provider catalog and compaction hooks.",
+      "framework": "Codex",
+      "language": "shell",
+      "category": "coding-agent",
+      "tags": [
+        "local",
+        "cli",
+        "agents"
+      ],
+      "protocol": "openai",
+      "homepage": "https://developers.openai.com/codex",
+      "bin": "codex",
+      "install": {
+        "darwin": "npm i -g @openai/codex",
+        "linux": "npm i -g @openai/codex",
+        "win32": "npm i -g @openai/codex"
+      },
+      "runbook": {
+        "mode": "launch",
+        "script": "codex/run.sh",
+        "setupScript": "codex/install.sh",
+        "setupActions": [
+          "install",
+          "status",
+          "uninstall"
+        ]
+      },
+      "launch": "codex -c model={model} -c model_provider=subconscious -c web_search=disabled -c model_providers.subconscious.name=Subconscious -c model_providers.subconscious.base_url={baseUrlV1} -c model_providers.subconscious.wire_api=responses -c model_providers.subconscious.env_key=SUBCONSCIOUS_API_KEY -c model_providers.subconscious.stream_idle_timeout_ms=300000",
+      "env": {
+        "SUBCONSCIOUS_API_KEY": "{apiKey}",
+        "SUBCONSCIOUS_GATEWAY_URL": "{baseUrl}"
       }
     },
     {
       "id": "opencode",
+      "command": "opencode",
       "exampleDir": "opencode",
       "name": "OpenCode",
       "aliases": [
         "open-code"
       ],
       "displayName": "OpenCode + Subconscious",
-      "description": "Run OpenCode on your hosted Subconscious model — registered as a custom provider, injected non-invasively (nothing written to your OpenCode config).",
+      "description": "Run OpenCode on your hosted Subconscious model with the Subconscious provider and context settings.",
       "framework": "OpenCode",
       "language": "shell",
       "category": "coding-agent",
@@ -69,25 +146,58 @@
         "linux": "npm i -g opencode-ai",
         "win32": "npm i -g opencode-ai"
       },
+      "runbook": {
+        "mode": "launch",
+        "script": "opencode/run.sh",
+        "setupScript": "opencode/install.sh",
+        "setupActions": [
+          "status",
+          "uninstall"
+        ]
+      },
       "launch": "opencode",
       "configEnv": "OPENCODE_CONFIG_CONTENT",
       "env": {
         "SUBCONSCIOUS_API_KEY": "{apiKey}",
+        "SUBCONSCIOUS_GATEWAY_URL": "{baseUrl}",
         "OPENCODE_CONFIG_CONTENT": {
           "$json": {
             "$schema": "https://opencode.ai/config.json",
             "provider": {
               "subconscious": {
                 "npm": "@ai-sdk/openai-compatible",
-                "name": "Subconscious",
+                "name": "Subconscious Gateway",
                 "options": {
                   "baseURL": "{baseUrlV1}",
-                  "apiKey": "{env:SUBCONSCIOUS_API_KEY}"
+                  "apiKey": "{env:SUBCONSCIOUS_API_KEY}",
+                  "headers": {
+                    "x-subconscious-client": "opencode"
+                  }
                 },
                 "models": {
-                  "{model}": {
-                    "name": "Subconscious",
-                    "tools": true
+                  "subconscious/glm-5.2": {
+                    "name": "subconscious/glm-5.2",
+                    "tools": true,
+                    "limit": {
+                      "context": 5000000,
+                      "output": 65536
+                    }
+                  },
+                  "subconscious/tim-qwen3.6-27b": {
+                    "name": "subconscious/tim-qwen3.6-27b",
+                    "tools": true,
+                    "limit": {
+                      "context": 5000000,
+                      "output": 65536
+                    }
+                  },
+                  "subconscious/deepseek-v4-flash-marathon": {
+                    "name": "subconscious/deepseek-v4-flash-marathon",
+                    "tools": true,
+                    "limit": {
+                      "context": 5000000,
+                      "output": 65536
+                    }
                   }
                 }
               }
@@ -98,42 +208,69 @@
       }
     },
     {
-      "id": "aider",
-      "exampleDir": "aider",
-      "name": "Aider",
+      "id": "cursor",
+      "command": "cursor",
+      "name": "Cursor",
       "aliases": [],
-      "displayName": "Aider + Subconscious",
-      "description": "Run Aider on your hosted Subconscious model — no code changes, just env vars.",
-      "framework": "Aider",
+      "description": "Install Cursor conversation and compaction hooks, then finish model setup in Cursor Settings.",
+      "framework": "Cursor",
       "language": "shell",
       "category": "coding-agent",
       "tags": [
         "local",
-        "cli",
+        "ide",
         "agents"
       ],
       "protocol": "openai",
-      "homepage": "https://aider.chat",
-      "bin": "aider",
-      "install": {
-        "darwin": "python3 -m pip install aider-install && aider-install",
-        "linux": "python3 -m pip install aider-install && aider-install",
-        "win32": "python -m pip install aider-install && aider-install"
-      },
-      "launch": "aider --model openai/{model}",
-      "env": {
-        "OPENAI_API_BASE": "{baseUrlV1}",
-        "OPENAI_API_KEY": "{apiKey}"
+      "homepage": "https://cursor.com",
+      "runbook": {
+        "mode": "setup",
+        "script": "cursor/install.sh",
+        "setupScript": "cursor/install.sh",
+        "setupActions": [
+          "install",
+          "status",
+          "uninstall"
+        ]
       }
     },
     {
-      "id": "codex",
-      "exampleDir": "codex",
-      "name": "Codex CLI",
+      "id": "copilot",
+      "command": "copilot",
+      "name": "GitHub Copilot (VS Code)",
+      "aliases": [
+        "vscode",
+        "vs-code"
+      ],
+      "description": "Install the VS Code custom endpoint and Copilot conversation/compaction hooks.",
+      "framework": "GitHub Copilot",
+      "language": "shell",
+      "category": "coding-agent",
+      "tags": [
+        "local",
+        "ide",
+        "agents"
+      ],
+      "protocol": "openai",
+      "homepage": "https://code.visualstudio.com/docs/copilot/overview",
+      "runbook": {
+        "mode": "setup",
+        "script": "copilot/install.sh",
+        "setupScript": "copilot/install.sh",
+        "setupActions": [
+          "install",
+          "status",
+          "uninstall"
+        ]
+      }
+    },
+    {
+      "id": "pi",
+      "command": "pi",
+      "name": "Pi",
       "aliases": [],
-      "displayName": "Codex + Subconscious",
-      "description": "Run the Codex CLI on your hosted Subconscious model via a custom OpenAI-compatible provider.",
-      "framework": "Codex",
+      "description": "Launch Pi with the Subconscious provider and active profile model configured by subc pi install.",
+      "framework": "Pi",
       "language": "shell",
       "category": "coding-agent",
       "tags": [
@@ -142,16 +279,17 @@
         "agents"
       ],
       "protocol": "openai",
-      "homepage": "https://developers.openai.com/codex",
-      "bin": "codex",
-      "install": {
-        "darwin": "npm i -g @openai/codex",
-        "linux": "npm i -g @openai/codex",
-        "win32": "npm i -g @openai/codex"
-      },
-      "launch": "codex -c model_providers.subconscious.name=Subconscious -c model_providers.subconscious.base_url={baseUrlV1} -c model_providers.subconscious.env_key=SUBCONSCIOUS_API_KEY -c model_provider=subconscious -c model={model}",
-      "env": {
-        "SUBCONSCIOUS_API_KEY": "{apiKey}"
+      "homepage": "https://pi.dev",
+      "bin": "pi",
+      "runbook": {
+        "mode": "launch",
+        "script": "pi/run.sh",
+        "setupScript": "pi/install.sh",
+        "setupActions": [
+          "install",
+          "status",
+          "uninstall"
+        ]
       }
     }
   ]

package/bin/runbook/README.md

@@ -0,0 +1,22 @@
+# Coding-agent integrations
+
+These scripts are part of `subc`. They launch or surgically install Claude Code,
+Codex, OpenCode, Cursor, Copilot, and Pi against the Subconscious gateway.
+
+`subc` reads `~/.subconscious/profiles/<name>.env` and injects those values into
+the scripts, so users do not need a sibling `.env` file. When a script is run
+directly, `SUBC_ENV_FILE` (or `cli/bin/runbook/.env`) can supply the same keys.
+
+Included integrations:
+
+- `claude-code/install.sh` and `run.sh`
+- `codex/install.sh`, `run.sh`, `hook.sh`, `hooks.json`, and `hooks-lib.sh`
+- `opencode/install.sh`, `run.sh`, and `subconscious-compaction.ts`
+- `cursor/install.sh`, `hook.sh`, and `hooks.json`
+- `copilot/install.sh`, `hook.sh`, and `hooks.json`
+- `pi/install.sh`, `run.sh`, and `subconscious-compaction.ts`
+
+Each CLI-enabled entry in `agents/registry.json` points here with a `runbook`
+block. Persistent writes are merge/unmerge only: they never replace a user's
+`config.toml`, `opencode.json`, `models.json`, `hooks.json`, or VS Code
+provider list.

package/bin/runbook/claude-code/install.sh

@@ -0,0 +1,290 @@
+#!/usr/bin/env bash
+# ── Subconscious API Gateway — Claude Code setup ──────────────────────────────
+# Point Claude Code at your gateway. Claude reads env vars, so the "install"
+# writes them to ~/.claude/subconscious-gateway.env and `use` launches claude.
+#
+# Quick start:
+#   ./install.sh --gateway-url https://your-gateway.example --api-key sk-gw-...
+#   ./install.sh use                    # launches claude with gateway env loaded
+#   ./install.sh use -- --continue      # pass args through to claude
+#
+# Or source env into your shell:
+#   source <(./install.sh env)          # load   ANTHROPIC_BASE_URL etc.
+#   source <(./install.sh unset)        # remove ANTHROPIC_BASE_URL etc.
+#
+#   ./install.sh status                 # show current config
+#   ./install.sh uninstall              # remove env file
+#
+# ── What this does under the hood ────────────────────────────────────────────
+# Equivalent manual setup (no script needed):
+#
+#   export ANTHROPIC_BASE_URL=https://your-gateway.example
+#   export ANTHROPIC_AUTH_TOKEN=sk-gw-...
+#   export ANTHROPIC_MODEL=subconscious/glm-5.2
+#   export ANTHROPIC_SMALL_FAST_MODEL=subconscious/glm-5.2
+#   export CLAUDE_CODE_SUBAGENT_MODEL=subconscious/glm-5.2
+#   export CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=4
+#   export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1
+#   export CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000
+#   export CLAUDE_CODE_MAX_CONTEXT_TOKENS=3000000
+#   # AUTO_COMPACT_WINDOW range 100000–1000000 (leave on; TIMRUN keys rarely hit it):
+#   # https://code.claude.com/docs/en/env-vars
+#   # https://code.claude.com/docs/en/context-window#set-the-auto-compact-window
+#   export CLAUDE_CODE_ENABLE_TELEMETRY=1
+#   export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+#   export OTEL_LOGS_EXPORTER=otlp
+#   export OTEL_EXPORTER_OTLP_PROTOCOL=http/json
+#   export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=https://your-gateway.example/v1/logs
+#   export OTEL_EXPORTER_OTLP_HEADERS="x-api-key=sk-gw-..."
+#   export OTEL_EXPORTER_OTLP_TIMEOUT=2000
+#   export OTEL_LOGS_EXPORT_INTERVAL=2000
+#   claude
+#
+# Claude Code sends native x-claude-code-session-id headers, so the gateway
+# correlates requests automatically. OTEL api_request logs → Claude Code-only
+# POST /v1/logs back-fill query_source (not a general logs API):
+# https://code.claude.com/docs/en/monitoring-usage#api-request-event
+# ─────────────────────────────────────────────────────────────────────────────
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Load shared env from SUBC_ENV_FILE, or a sibling .env / env.example.
+SHARED_ENV="${SUBC_ENV_FILE:-${SCRIPT_DIR}/../.env}"
+[[ -f "$SHARED_ENV" ]] || SHARED_ENV="${SCRIPT_DIR}/../env.example"
+if [[ -f "$SHARED_ENV" ]]; then set -a; source "$SHARED_ENV"; set +a; fi
+
+CLAUDE_DIR="${HOME}/.claude"
+ENV_FILE="${CLAUDE_DIR}/subconscious-gateway.env"
+DEFAULT_MODEL="subconscious/glm-5.2"
+DEFAULT_COMPACT_WINDOW="1000000"
+DEFAULT_MAX_CONTEXT_TOKENS="3000000"
+DEFAULT_MAX_CONCURRENT_SUBAGENTS="4"
+DEFAULT_MAX_SUBAGENT_SPAWN_DEPTH="1"
+DEFAULT_OPUS_MODEL="subconscious/glm-5.2"
+DEFAULT_SONNET_MODEL="subconscious/tim-qwen3.6-27b"
+DEFAULT_HAIKU_MODEL="subconscious/deepseek-v4-flash-marathon"
+
+GATEWAY_URL="${GATEWAY_URL:-}"
+API_KEY="${CLAUDE_CODE_API_KEY:-${API_KEY:-}}"
+MODEL="${MODEL:-$DEFAULT_MODEL}"
+COMPACT_WINDOW="${CLAUDE_CODE_AUTO_COMPACT_WINDOW:-${COMPACT_WINDOW:-$DEFAULT_COMPACT_WINDOW}}"
+MAX_CONTEXT_TOKENS="${CLAUDE_CODE_MAX_CONTEXT_TOKENS:-${MAX_CONTEXT_TOKENS:-$DEFAULT_MAX_CONTEXT_TOKENS}}"
+MAX_CONCURRENT_SUBAGENTS="${MAX_CONCURRENT_SUBAGENTS:-$DEFAULT_MAX_CONCURRENT_SUBAGENTS}"
+MAX_SUBAGENT_SPAWN_DEPTH="${MAX_SUBAGENT_SPAWN_DEPTH:-$DEFAULT_MAX_SUBAGENT_SPAWN_DEPTH}"
+OPUS_MODEL="${ANTHROPIC_DEFAULT_OPUS_MODEL:-$DEFAULT_OPUS_MODEL}"
+OPUS_MODEL_NAME="${ANTHROPIC_DEFAULT_OPUS_MODEL_NAME:-$OPUS_MODEL}"
+OPUS_MODEL_DESCRIPTION="${ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION:-Subconscious default model}"
+SONNET_MODEL="${ANTHROPIC_DEFAULT_SONNET_MODEL:-$DEFAULT_SONNET_MODEL}"
+SONNET_MODEL_NAME="${ANTHROPIC_DEFAULT_SONNET_MODEL_NAME:-$SONNET_MODEL}"
+SONNET_MODEL_DESCRIPTION="${ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION:-Subconscious TIM Qwen 3.6 27B}"
+HAIKU_MODEL="${ANTHROPIC_DEFAULT_HAIKU_MODEL:-$DEFAULT_HAIKU_MODEL}"
+HAIKU_MODEL_NAME="${ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME:-$HAIKU_MODEL}"
+HAIKU_MODEL_DESCRIPTION="${ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION:-Subconscious DeepSeek V4 Flash Marathon}"
+COMMAND="install"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  subc claude status
+  subc claude uninstall
+  subc claude help
+
+Claude Code is launch-only: subc claude. Uninstall removes leftover
+~/.claude/subconscious-gateway.env from older persistent setup.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    install|use|env|unset|uninstall|status|help)
+      COMMAND="$1"
+      shift
+      ;;
+    --gateway-url)
+      GATEWAY_URL="${2:-}"
+      shift 2
+      ;;
+    --api-key)
+      API_KEY="${2:-}"
+      shift 2
+      ;;
+    --model)
+      MODEL="${2:-}"
+      shift 2
+      ;;
+    --compact-window)
+      COMPACT_WINDOW="${2:-}"
+      shift 2
+      ;;
+    --max-context-tokens)
+      MAX_CONTEXT_TOKENS="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    --)
+      shift
+      break
+      ;;
+    *)
+      echo "unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Optional CLAUDE_GATEWAY_URL in shared .env overrides GATEWAY_URL for Claude only.
+resolve_claude_gateway_url() {
+  printf '%s' "${CLAUDE_GATEWAY_URL:-$GATEWAY_URL}"
+}
+
+write_env() {
+  local effective_gateway_url
+  effective_gateway_url="$(resolve_claude_gateway_url)"
+  mkdir -p "$CLAUDE_DIR"
+  umask 077
+  cat >"$ENV_FILE" <<EOF
+# Generated by subc — do not commit secrets.
+export ANTHROPIC_BASE_URL="${effective_gateway_url}"
+export ANTHROPIC_AUTH_TOKEN="${API_KEY}"
+export ANTHROPIC_MODEL="${MODEL}"
+export ANTHROPIC_SMALL_FAST_MODEL="${MODEL}"
+export ANTHROPIC_DEFAULT_OPUS_MODEL="${OPUS_MODEL}"
+export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME="${OPUS_MODEL_NAME}"
+export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION="${OPUS_MODEL_DESCRIPTION}"
+export ANTHROPIC_DEFAULT_SONNET_MODEL="${SONNET_MODEL}"
+export ANTHROPIC_DEFAULT_SONNET_MODEL_NAME="${SONNET_MODEL_NAME}"
+export ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION="${SONNET_MODEL_DESCRIPTION}"
+export ANTHROPIC_DEFAULT_HAIKU_MODEL="${HAIKU_MODEL}"
+export ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME="${HAIKU_MODEL_NAME}"
+export ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION="${HAIKU_MODEL_DESCRIPTION}"
+export CLAUDE_CODE_SUBAGENT_MODEL="${MODEL}"
+export CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS="${MAX_CONCURRENT_SUBAGENTS}"
+export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH="${MAX_SUBAGENT_SPAWN_DEPTH}"
+export CLAUDE_CODE_AUTO_COMPACT_WINDOW="${COMPACT_WINDOW}"
+export CLAUDE_CODE_MAX_CONTEXT_TOKENS="${MAX_CONTEXT_TOKENS}"
+export CLAUDE_CODE_ENABLE_TELEMETRY=1
+export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+# Claude Code purpose attribution only (api_request → /v1/logs):
+# https://code.claude.com/docs/en/monitoring-usage#api-request-event
+export OTEL_LOGS_EXPORTER=otlp
+export OTEL_EXPORTER_OTLP_PROTOCOL=http/json
+export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="${effective_gateway_url%/}/v1/logs"
+export OTEL_EXPORTER_OTLP_HEADERS="x-api-key=${API_KEY}"
+export OTEL_EXPORTER_OTLP_TIMEOUT=2000
+export OTEL_LOGS_EXPORT_INTERVAL=2000
+EOF
+  chmod 600 "$ENV_FILE"
+}
+
+print_env_exports() {
+  if [[ ! -f "$ENV_FILE" ]]; then
+    echo "env file not found: $ENV_FILE" >&2
+    echo "Launch Claude with: subc claude" >&2
+    return 1
+  fi
+  cat "$ENV_FILE"
+}
+
+print_env_unsets() {
+  cat <<'EOF'
+unset ANTHROPIC_BASE_URL
+unset ANTHROPIC_AUTH_TOKEN
+unset ANTHROPIC_MODEL
+unset ANTHROPIC_SMALL_FAST_MODEL
+unset ANTHROPIC_DEFAULT_OPUS_MODEL
+unset ANTHROPIC_DEFAULT_OPUS_MODEL_NAME
+unset ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION
+unset ANTHROPIC_DEFAULT_SONNET_MODEL
+unset ANTHROPIC_DEFAULT_SONNET_MODEL_NAME
+unset ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION
+unset ANTHROPIC_DEFAULT_HAIKU_MODEL
+unset ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME
+unset ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION
+unset CLAUDE_CODE_SUBAGENT_MODEL
+unset CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS
+unset CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH
+unset CLAUDE_CODE_AUTO_COMPACT_WINDOW
+unset CLAUDE_CODE_MAX_CONTEXT_TOKENS
+unset CLAUDE_CODE_ENABLE_TELEMETRY
+unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
+unset OTEL_LOGS_EXPORTER
+unset OTEL_EXPORTER_OTLP_PROTOCOL
+unset OTEL_EXPORTER_OTLP_LOGS_ENDPOINT
+unset OTEL_EXPORTER_OTLP_HEADERS
+unset OTEL_EXPORTER_OTLP_TIMEOUT
+unset OTEL_LOGS_EXPORT_INTERVAL
+EOF
+}
+
+status() {
+  echo "scope: user"
+  echo "claude dir: $CLAUDE_DIR"
+  echo "env file: $ENV_FILE"
+  if [[ -f "$ENV_FILE" ]]; then
+    # shellcheck disable=SC1090
+    source "$ENV_FILE"
+    echo "gateway: ${ANTHROPIC_BASE_URL:-unset}"
+    if [[ -n "${ANTHROPIC_AUTH_TOKEN:-}" ]]; then
+      echo "api key: set (${#ANTHROPIC_AUTH_TOKEN} chars)"
+    else
+      echo "api key: unset"
+    fi
+    echo "model: ${ANTHROPIC_MODEL:-unset}"
+    echo "model picker: ${ANTHROPIC_DEFAULT_OPUS_MODEL_NAME:-unset}, ${ANTHROPIC_DEFAULT_SONNET_MODEL_NAME:-unset}, ${ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME:-unset}"
+    echo "max concurrent subagents: ${CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS:-unset}"
+    echo "max subagent spawn depth: ${CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH:-unset}"
+    echo "compact window: ${CLAUDE_CODE_AUTO_COMPACT_WINDOW:-unset}"
+    echo "max context tokens: ${CLAUDE_CODE_MAX_CONTEXT_TOKENS:-unset}"
+  else
+    echo "env file: missing"
+    echo "Launch Claude with: subc claude"
+  fi
+}
+
+case "$COMMAND" in
+  install)
+    if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
+      echo "--gateway-url and --api-key are required for install" >&2
+      exit 1
+    fi
+    write_env
+    echo "Wrote leftover env file $ENV_FILE"
+    echo "Launch Claude with: subc claude"
+    ;;
+  use)
+    if [[ ! -f "$ENV_FILE" ]]; then
+    echo "env file not found: $ENV_FILE" >&2
+    echo "Launch Claude with: subc claude" >&2
+      exit 1
+    fi
+    # shellcheck disable=SC1090
+    source "$ENV_FILE"
+    if ! command -v claude >/dev/null 2>&1; then
+      echo "claude CLI not found in PATH" >&2
+      exit 1
+    fi
+    exec claude "$@"
+    ;;
+  env)
+    print_env_exports
+    ;;
+  unset)
+    print_env_unsets
+    ;;
+  uninstall)
+    rm -f "$ENV_FILE"
+    echo "Removed $ENV_FILE"
+    ;;
+  status)
+    status
+    ;;
+  help)
+    usage
+    ;;
+esac