subconscious-cli 0.2.1 → 0.3.0

package/bin/runbook/cursor/install.sh

@@ -0,0 +1,259 @@
+#!/usr/bin/env bash
+# ── Subconscious API Gateway — Cursor hooks setup ─────────────────────────────
+# Install Cursor hooks that announce each agent handoff to your gateway so
+# /v1/chat/completions requests are grouped into Conversations.
+#
+# Quick start:
+#   ./install.sh --gateway-url https://your-gateway.example --api-key sk-gw-...
+#   ./install.sh status                 # show current hook config
+#   ./install.sh uninstall              # remove hooks
+#
+# Cursor model/URL are set in Cursor settings (OpenAI API Key Override), not
+# here. This script installs the conversation-correlation hooks (user-wide
+# under ~/.cursor). Restart Cursor after install so it reloads hooks.json.
+#
+# ── What this does under the hood ────────────────────────────────────────────
+# Equivalent manual setup (three pieces):
+#
+#   1. Cursor settings → enable "OpenAI API Key Override":
+#        Base URL: https://your-gateway.example
+#        API Key:  sk-gw-...
+#
+#   2. Write ~/.cursor/hooks.json pointing at the hook script:
+#        {
+#          "version": 1,
+#          "hooks": {
+#            "beforeSubmitPrompt": [{ "command": "~/.cursor/hooks/subconscious-hook.sh", "timeout": 2 }],
+#            "preCompact": [{ "command": "~/.cursor/hooks/subconscious-hook.sh", "timeout": 2 }]
+#          }
+#        }
+#
+#   3. Write ~/.cursor/subconscious-hooks.env (mode 600):
+#        export SUBCONSCIOUS_GATEWAY_URL=https://your-gateway.example
+#        export SUBCONSCIOUS_API_KEY=sk-gw-...
+#
+# The hook script (hook.sh) POSTs conversation_ensure to /v1/agent-hooks with the raw
+# prompt text once per submission. The gateway fingerprints the prompt itself,
+# binds the first LLM request of that prompt, then chains every later turn of the
+# conversation onto it -- including subagents. Unlike Claude Code / Pi /
+# OpenCode, Cursor has no native session headers and hooks cannot inject headers
+# into model HTTP, so this announcement is required for correlation.
+# ─────────────────────────────────────────────────────────────────────────────
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK_SRC="${SCRIPT_DIR}/hook.sh"
+HOOKS_TEMPLATE="${SCRIPT_DIR}/hooks.json"
+
+# Load shared env from coding-agents/.env (gitignored) or env.example.
+SHARED_ENV="${MBTA_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
+
+GATEWAY_URL="${GATEWAY_URL:-}"
+API_KEY="${CURSOR_API_KEY:-${API_KEY:-}}"
+COMMAND="install"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  install.sh [install] --gateway-url URL --api-key KEY
+  install.sh uninstall
+  install.sh status
+
+`install` is the default subcommand and may be omitted.
+
+Installs Cursor hooks (user-wide under ~/.cursor) that POST to /v1/agent-hooks:
+conversation_ensure on each prompt submission so the gateway can group
+Conversations for Cursor traffic, and conversation_compaction on preCompact so
+context accounting restarts at the right turn.
+
+Requires: jq, curl. Restart Cursor after install.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    install|uninstall|status)
+      COMMAND="$1"
+      shift
+      ;;
+    --gateway-url)
+      GATEWAY_URL="${2:-}"
+      shift 2
+      ;;
+    --api-key)
+      API_KEY="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+CURSOR_DIR="${HOME}/.cursor"
+HOOKS_JSON="${CURSOR_DIR}/hooks.json"
+HOOK_DST="${CURSOR_DIR}/hooks/subconscious-hook.sh"
+ENV_FILE="${CURSOR_DIR}/subconscious-hooks.env"
+MARKER="subconscious-hook.sh"
+
+require_cmds() {
+  local missing=0
+  for c in jq curl; do
+    if ! command -v "$c" >/dev/null 2>&1; then
+      echo "missing required command: $c" >&2
+      missing=1
+    fi
+  done
+  if [[ "$missing" -ne 0 ]]; then
+    exit 1
+  fi
+}
+
+write_env() {
+  umask 077
+  cat >"$ENV_FILE" <<EOF
+# Generated by ol-runbook/coding-agents/cursor/install.sh — do not commit secrets.
+export SUBCONSCIOUS_GATEWAY_URL='${GATEWAY_URL}'
+export SUBCONSCIOUS_API_KEY='${API_KEY}'
+EOF
+  chmod 600 "$ENV_FILE"
+}
+
+install_hook_script() {
+  mkdir -p "$(dirname "$HOOK_DST")"
+  cp "$HOOK_SRC" "$HOOK_DST"
+  chmod +x "$HOOK_DST"
+}
+
+# merge_hook_entries <hooks_json> <marker> <command> <event> [<event>...]
+#
+# Additive, idempotent merge of a single hook command into one or more events
+# of a hooks.json file. Preserves ALL other entries verbatim, including
+# third-party hooks, prompt hooks (no `command` field), and unknown events.
+#
+# Invariants:
+#  - Only entries whose `command` contains <marker> are replaced; others untouched.
+#  - Running twice yields the same result as once (idempotent, order-stable).
+#  - Entries without a `command` field are never matched/removed.
+#  - Missing/empty file is initialized to {"version":1,"hooks":{}}.
+merge_hook_entries() {
+  local hooks_json="$1" marker="$2" command="$3"
+  shift 3
+  local events
+  events="$(printf '%s\n' "$@" | jq -R . | jq -s .)"
+
+  if [[ ! -f "$hooks_json" ]]; then
+    printf '%s\n' '{"version":1,"hooks":{}}' >"$hooks_json"
+  fi
+
+  local tmp
+  tmp="$(mktemp)"
+  jq --arg marker "$marker" --arg cmd "$command" --argjson events "$events" '
+    .version = (.version // 1) |
+    .hooks = (.hooks // {}) |
+    # Strip prior entries with our marker from every event, keep everything else.
+    .hooks |= with_entries(
+      .value = ((.value // []) | map(select((.command // "") | tostring | contains($marker) | not)))
+    ) |
+    # Append our entry to each requested event (preserving any other entries).
+    .hooks = (.hooks | reduce ($events[]) as $e (.;
+      .[$e] = ((.[$e] // []) + [{"command": $cmd, "timeout": 2}])
+    ))
+  ' "$hooks_json" >"$tmp"
+  mv "$tmp" "$hooks_json"
+}
+
+# remove_hook_entries <hooks_json> <marker>
+#
+# Remove every entry whose `command` contains <marker> from all events.
+# Preserves all other entries (third-party, prompt hooks, unknown events).
+remove_hook_entries() {
+  local hooks_json="$1" marker="$2"
+  [[ -f "$hooks_json" ]] || return 0
+  local tmp
+  tmp="$(mktemp)"
+  jq --arg marker "$marker" '
+    .hooks //= {} |
+    .hooks |= with_entries(
+      .value = ((.value // []) | map(select((.command // "") | tostring | contains($marker) | not)))
+    )
+  ' "$hooks_json" >"$tmp"
+  mv "$tmp" "$hooks_json"
+}
+
+merge_hooks_json() {
+  if [[ ! -f "$HOOKS_JSON" ]]; then
+    sed "s|HOOK_SH_PATH|${HOOK_DST}|g" "$HOOKS_TEMPLATE" >"$HOOKS_JSON"
+    return
+  fi
+  # Replace our marker entries, then register the two lifecycle events we use.
+  remove_hook_entries "$HOOKS_JSON" "$MARKER"
+  merge_hook_entries "$HOOKS_JSON" "$MARKER" "$HOOK_DST" beforeSubmitPrompt preCompact
+}
+
+uninstall_hooks() {
+  remove_hook_entries "$HOOKS_JSON" "$MARKER"
+  rm -f "$HOOK_DST" "$ENV_FILE"
+}
+
+status() {
+  echo "cursor dir: $CURSOR_DIR"
+  echo "hooks.json: $HOOKS_JSON"
+  if [[ -f "$HOOKS_JSON" ]] && jq -e --arg m "$MARKER" '
+      [.hooks[]?[]? | select((.command // "") | tostring | contains($m))] | length > 0
+    ' "$HOOKS_JSON" >/dev/null 2>&1; then
+    echo "hooks: installed"
+  else
+    echo "hooks: not installed"
+  fi
+  if [[ -f "$ENV_FILE" ]]; then
+    echo "env: $ENV_FILE (present)"
+    # shellcheck disable=SC1090
+    source "$ENV_FILE"
+    echo "gateway: ${SUBCONSCIOUS_GATEWAY_URL:-unset}"
+    if [[ -n "${SUBCONSCIOUS_API_KEY:-}" ]]; then
+      echo "api key: set (${#SUBCONSCIOUS_API_KEY} chars)"
+    else
+      echo "api key: unset"
+    fi
+  else
+    echo "env: missing"
+  fi
+  if [[ -x "$HOOK_DST" ]]; then
+    echo "hook script: $HOOK_DST (executable)"
+  else
+    echo "hook script: missing"
+  fi
+}
+
+case "$COMMAND" in
+  install)
+    require_cmds
+    if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
+      echo "--gateway-url and --api-key are required for install" >&2
+      exit 1
+    fi
+    mkdir -p "$CURSOR_DIR"
+    install_hook_script
+    write_env
+    merge_hooks_json
+    echo "Installed Subconscious Cursor hooks into $CURSOR_DIR"
+    echo "Restart Cursor to reload hooks.json."
+    ;;
+  uninstall)
+    uninstall_hooks
+    echo "Removed Subconscious Cursor hooks from $CURSOR_DIR"
+    ;;
+  status)
+    status
+    ;;
+esac

package/bin/runbook/opencode/install.sh

@@ -0,0 +1,298 @@
+#!/usr/bin/env bash
+# ── Subconscious API Gateway — OpenCode setup ─────────────────────────────────
+# Point OpenCode at your gateway. Writes a provider config with session headers
+# so the gateway can correlate OpenCode requests into Conversations.
+#
+# Quick start:
+#   ./install.sh --gateway-url https://your-gateway.example --api-key sk-gw-...
+#   ./install.sh status                 # show current config
+#   ./install.sh uninstall              # revert to default opencode config
+#
+# Writes ~/.opencode/opencode.json (user config). Does not touch project-level
+# opencode.json files. Restart opencode after install.
+#
+# ── What this does under the hood ────────────────────────────────────────────
+# Equivalent manual setup (writes ~/.opencode/opencode.json + env var):
+#
+#   export SUBCONSCIOUS_API_KEY=sk-gw-...
+#   cat > ~/.opencode/opencode.json <<'EOF'
+#   {
+#     "$schema": "https://opencode.ai/config.json",
+#     "provider": {
+#       "subconscious": {
+#         "npm": "@ai-sdk/openai-compatible",
+#         "name": "Subconscious Gateway",
+#         "options": {
+#           "baseURL": "https://your-gateway.example/v1",
+#           "apiKey": "{env:SUBCONSCIOUS_API_KEY}",
+#           "headers": { "x-subconscious-client": "opencode" }
+#         },
+#         "models": {
+#           "subconscious/glm-5.2": {
+#             "name": "subconscious/glm-5.2",
+#             "tools": true,
+#             "limit": { "context": 5000000, "output": 65536 }
+#           }
+#         }
+#       }
+#     },
+#     "model": "subconscious/subconscious/glm-5.2"
+#   }
+#   EOF
+#   opencode
+#
+# The x-subconscious-client header tells the gateway to classify traffic as
+# OpenCode. OpenCode also sends native x-session-affinity / x-session-id
+# headers for conversation correlation. Model limit.context drives auto
+# compaction (default on); custom providers do not inherit models.dev limits.
+#
+# Also installs a plugin that reports compactions to the gateway. OpenCode
+# summarizes through the configured provider, so without it the gateway counts
+# that summarization as a normal main-thread turn.
+# ─────────────────────────────────────────────────────────────────────────────
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Load shared env from coding-agents/.env (gitignored) or env.example.
+SHARED_ENV="${MBTA_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
+
+COMMAND="install"
+GATEWAY_URL="${GATEWAY_URL:-}"
+API_KEY="${OPENCODE_API_KEY:-${API_KEY:-}}"
+MODEL="${MODEL:-subconscious/glm-5.2}"
+# OpenCode auto-compaction uses model limit.context. Custom openai-compatible
+# providers do not get that from baseURL/models.dev; set it explicitly.
+CONTEXT_LIMIT="${OPENCODE_CONTEXT_LIMIT:-5000000}"
+OUTPUT_LIMIT="${OPENCODE_OUTPUT_LIMIT:-65536}"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  install.sh [install] --gateway-url URL --api-key KEY [--model MODEL]
+             [--context-limit N] [--output-limit N]
+  install.sh uninstall
+  install.sh status
+
+`install` is the default subcommand and may be omitted.
+
+Writes an opencode.json that points opencode at your Subconscious gateway with
+x-subconscious-client: opencode and x-session-affinity/x-session-id session
+headers so the gateway can group requests into Conversations.
+
+Also sets model limit.context / limit.output so OpenCode auto-compaction
+respects the gateway window (compaction.auto stays enabled / default), and
+installs a plugin that reports compactions so the dashboard can restart context
+accounting at the right turn.
+
+Requires: jq. Restart opencode after install.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    install|uninstall|status)
+      COMMAND="$1"
+      shift
+      ;;
+    --gateway-url)
+      GATEWAY_URL="${2:-}"
+      shift 2
+      ;;
+    --api-key)
+      API_KEY="${2:-}"
+      shift 2
+      ;;
+    --model)
+      MODEL="${2:-}"
+      shift 2
+      ;;
+    --context-limit)
+      CONTEXT_LIMIT="${2:-}"
+      shift 2
+      ;;
+    --output-limit)
+      OUTPUT_LIMIT="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+subconscious/tim-qwen3.6-27b
+subconscious/deepseek-v4-flash-marathon"
+SUPPORTED_MODELS=()
+
+add_supported_model() {
+  local model_id="$1" existing
+  [[ -n "$model_id" ]] || return 0
+  if [[ ! "$model_id" =~ ^[-A-Za-z0-9._:/+]+$ ]]; then
+    echo "error: invalid model id: $model_id" >&2
+    exit 1
+  fi
+  if [[ "${#SUPPORTED_MODELS[@]}" -gt 0 ]]; then
+    for existing in "${SUPPORTED_MODELS[@]}"; do
+      [[ "$existing" == "$model_id" ]] && return 0
+    done
+  fi
+  SUPPORTED_MODELS+=("$model_id")
+}
+
+add_supported_model "$MODEL"
+while IFS= read -r model_id; do
+  add_supported_model "$model_id"
+done <<< "${SUBCONSCIOUS_MODELS:-$DEFAULT_SUBCONSCIOUS_MODELS}"
+
+MODELS_JSON=""
+for model_id in "${SUPPORTED_MODELS[@]}"; do
+  model_json="\"${model_id}\":{\"name\":\"${model_id}\",\"tools\":true,\"limit\":{\"context\":${CONTEXT_LIMIT},\"output\":${OUTPUT_LIMIT}}}"
+  if [[ -n "$MODELS_JSON" ]]; then
+    MODELS_JSON="${MODELS_JSON},${model_json}"
+  else
+    MODELS_JSON="$model_json"
+  fi
+done
+
+OPENCODE_DIR="${HOME}/.opencode"
+OPENCODE_CONFIG="${OPENCODE_DIR}/opencode.json"
+MARKER='x-subconscious-client'
+# Plugins load from the XDG config dir, which is separate from the legacy ~/.opencode
+# config path above. Docs: https://opencode.ai/docs/plugins/
+PLUGIN_DIR="${XDG_CONFIG_HOME:-${HOME}/.config}/opencode/plugins"
+PLUGIN_FILE="${PLUGIN_DIR}/subconscious-compaction.ts"
+PLUGIN_SOURCE="${SCRIPT_DIR}/subconscious-compaction.ts"
+
+require_cmds() {
+  local missing=0
+  for c in jq; do
+    if ! command -v "$c" >/dev/null 2>&1; then
+      echo "missing required command: $c" >&2
+      missing=1
+    fi
+  done
+  if [[ "$missing" -ne 0 ]]; then
+    exit 1
+  fi
+}
+
+write_config() {
+  mkdir -p "$OPENCODE_DIR"
+  local base_url="${GATEWAY_URL%/}/v1"
+  local config
+  config=$(cat <<EOF
+{
+  "\$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "subconscious": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "Subconscious Gateway",
+      "options": {
+        "baseURL": "${base_url}",
+        "apiKey": "{env:SUBCONSCIOUS_API_KEY}",
+        "headers": {
+          "x-subconscious-client": "opencode"
+        }
+      },
+      "models": {${MODELS_JSON}}
+    }
+  },
+  "model": "subconscious/${MODEL}"
+}
+EOF
+)
+  echo "$config" >"$OPENCODE_CONFIG"
+  # Also export the API key into the shell env file for interactive sessions. The plugin
+  # reads the gateway URL from the same file.
+  local env_file="${OPENCODE_DIR}/subconscious.env"
+  umask 077
+  cat >"$env_file" <<EOF
+# Generated by ol-runbook/coding-agents/opencode/install.sh — do not commit secrets.
+export SUBCONSCIOUS_API_KEY='${API_KEY}'
+export SUBCONSCIOUS_GATEWAY_URL='${GATEWAY_URL%/}'
+EOF
+  chmod 600 "$env_file"
+}
+
+write_plugin() {
+  if [[ ! -f "$PLUGIN_SOURCE" ]]; then
+    echo "warning: ${PLUGIN_SOURCE} missing; skipping compaction plugin" >&2
+    return
+  fi
+  mkdir -p "$PLUGIN_DIR"
+  cp "$PLUGIN_SOURCE" "$PLUGIN_FILE"
+}
+
+uninstall_config() {
+  if [[ -f "$OPENCODE_CONFIG" ]] && grep -q "$MARKER" "$OPENCODE_CONFIG" 2>/dev/null; then
+    rm -f "$OPENCODE_CONFIG"
+  fi
+  rm -f "${OPENCODE_DIR}/subconscious.env"
+  rm -f "$PLUGIN_FILE"
+}
+
+status() {
+  echo "scope: user"
+  echo "opencode dir: $OPENCODE_DIR"
+  echo "config: $OPENCODE_CONFIG"
+  if [[ -f "$PLUGIN_FILE" ]]; then
+    echo "compaction plugin: $PLUGIN_FILE (installed)"
+  else
+    echo "compaction plugin: not installed"
+  fi
+  if [[ -f "$OPENCODE_CONFIG" ]] && grep -q "$MARKER" "$OPENCODE_CONFIG" 2>/dev/null; then
+    echo "status: installed"
+    echo "model: $(jq -r '.model // "unset"' "$OPENCODE_CONFIG" 2>/dev/null || echo 'unknown')"
+    echo "context limit: $(jq -r '
+      (.model // "") as $m
+      | ($m | sub("^subconscious/"; "")) as $id
+      | .provider.subconscious.models[$id].limit.context // "unset"
+    ' "$OPENCODE_CONFIG" 2>/dev/null || echo 'unknown')"
+    echo "compaction.auto: $(jq -r '.compaction.auto // true' "$OPENCODE_CONFIG" 2>/dev/null || echo 'unknown')"
+  else
+    echo "status: not installed"
+  fi
+  if [[ -f "${OPENCODE_DIR}/subconscious.env" ]]; then
+    echo "env: ${OPENCODE_DIR}/subconscious.env (present)"
+  else
+    echo "env: missing"
+  fi
+}
+
+case "$COMMAND" in
+  install)
+    require_cmds
+    if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
+      echo "--gateway-url and --api-key are required for install" >&2
+      exit 1
+    fi
+    write_config
+    write_plugin
+    echo "Installed Subconscious OpenCode config at $OPENCODE_CONFIG"
+    if [[ -f "$PLUGIN_FILE" ]]; then
+      echo "Installed compaction reporting plugin at $PLUGIN_FILE"
+    fi
+    echo "Source the env file before launching opencode:"
+    echo "  source ${OPENCODE_DIR}/subconscious.env"
+    echo "Or export SUBCONSCIOUS_API_KEY in your shell profile."
+    echo "Restart any running opencode sessions."
+    ;;
+  uninstall)
+    uninstall_config
+    echo "Removed Subconscious OpenCode config from $OPENCODE_DIR"
+    ;;
+  status)
+    status
+    ;;
+esac

package/bin/runbook/opencode/run.sh

@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+# Point OpenCode at the Subconscious gateway — ephemerally.
+#
+# Exports SUBCONSCIOUS_API_KEY and OPENCODE_CONFIG_CONTENT as env vars so
+# nothing is written to ~/.opencode/opencode.json. OpenCode reads the
+# config from the OPENCODE_CONFIG_CONTENT env var at startup.
+#
+# Usage:
+#   ./run.sh                         # uses GATEWAY_URL/API_KEY from ../.env
+#   ./run.sh -- auth                 # pass args through to opencode
+#
+# Config: copy ../env.example to ../.env and edit. .env is gitignored.
+# All agents share one coding-agents/.env file.
+#
+# Or source it to just export the env:
+#   source run.sh
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Load shared env from coding-agents/.env (gitignored) or env.example.
+SHARED_ENV="${MBTA_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
+
+GATEWAY_URL="${GATEWAY_URL:-}"
+API_KEY="${OPENCODE_API_KEY:-${API_KEY:-}}"
+MODEL="${MODEL:-subconscious/glm-5.2}"
+CONTEXT_LIMIT="${OPENCODE_CONTEXT_LIMIT:-5000000}"
+OUTPUT_LIMIT="${OPENCODE_OUTPUT_LIMIT:-65536}"
+
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+subconscious/tim-qwen3.6-27b
+subconscious/deepseek-v4-flash-marathon"
+SUPPORTED_MODELS=()
+
+add_supported_model() {
+  local model_id="$1" existing
+  [[ -n "$model_id" ]] || return 0
+  if [[ ! "$model_id" =~ ^[-A-Za-z0-9._:/+]+$ ]]; then
+    echo "error: invalid model id: $model_id" >&2
+    exit 1
+  fi
+  if [[ "${#SUPPORTED_MODELS[@]}" -gt 0 ]]; then
+    for existing in "${SUPPORTED_MODELS[@]}"; do
+      [[ "$existing" == "$model_id" ]] && return 0
+    done
+  fi
+  SUPPORTED_MODELS+=("$model_id")
+}
+
+add_supported_model "$MODEL"
+while IFS= read -r model_id; do
+  add_supported_model "$model_id"
+done <<< "${SUBCONSCIOUS_MODELS:-$DEFAULT_SUBCONSCIOUS_MODELS}"
+
+MODELS_JSON=""
+for model_id in "${SUPPORTED_MODELS[@]}"; do
+  model_json="\"${model_id}\":{\"name\":\"${model_id}\",\"tools\":true,\"limit\":{\"context\":${CONTEXT_LIMIT},\"output\":${OUTPUT_LIMIT}}}"
+  if [[ -n "$MODELS_JSON" ]]; then
+    MODELS_JSON="${MODELS_JSON},${model_json}"
+  else
+    MODELS_JSON="$model_json"
+  fi
+done
+
+if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
+  echo "error: GATEWAY_URL and API_KEY must be set in ../.env" >&2
+  exit 1
+fi
+
+# Parse args (only when executed, not sourced)
+PASSTHRU=()
+if [[ "${BASH_SOURCE[0]:-$0}" == "${0}" ]]; then
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --)
+        shift
+        PASSTHRU+=("$@")
+        break
+        ;;
+      *)
+        PASSTHRU+=("$1")
+        shift
+        ;;
+    esac
+  done
+fi
+
+BASE_URL="${GATEWAY_URL%/}/v1"
+
+export SUBCONSCIOUS_API_KEY="$API_KEY"
+# Read by the compaction plugin when it is installed. run.sh writes nothing to disk, so
+# use install.sh if you want compaction reporting.
+export SUBCONSCIOUS_GATEWAY_URL="${GATEWAY_URL%/}"
+export OPENCODE_CONFIG_CONTENT=$(cat <<EOF
+{"\$schema":"https://opencode.ai/config.json","provider":{"subconscious":{"npm":"@ai-sdk/openai-compatible","name":"Subconscious Gateway","options":{"baseURL":"${BASE_URL}","apiKey":"{env:SUBCONSCIOUS_API_KEY}","headers":{"x-subconscious-client":"opencode"}},"models":{${MODELS_JSON}}}},"model":"subconscious/${MODEL}"}
+EOF
+)
+
+# If sourced, just export env and return.
+if [[ "${BASH_SOURCE[0]:-$0}" != "${0}" ]]; then
+  return 0 2>/dev/null || true
+fi
+
+exec opencode ${PASSTHRU[@]+"${PASSTHRU[@]}"}