subconscious-cli 0.3.0 → 0.3.1

package/bin/runbook/codex/install.sh

@@ -1,145 +1,44 @@
 #!/usr/bin/env bash
-# ── Subconscious API Gateway — Codex setup ────────────────────────────────────
-# Point the Codex CLI at your gateway. Writes a provider config with session
-# headers so the gateway can correlate Codex requests into Conversations.
+# ── Subconscious API Gateway — Codex hooks ────────────────────────────────────
+# Merge Subconscious compaction hooks into ~/.codex/hooks.json without touching
+# ~/.codex/config.toml. Launch Codex with `subc codex`.
 #
-# Quick start:
-#   ./install.sh --gateway-url https://your-gateway.example --api-key sk-gw-...
-#   ./install.sh use                    # launches codex with gateway env loaded
-#   ./install.sh use -- --resume        # pass args through to codex
-#
-# Or source env into your shell:
-#   source <(./install.sh env)          # load   SUBCONSCIOUS_API_KEY
-#   source <(./install.sh unset)        # remove SUBCONSCIOUS_API_KEY
-#
-#   ./install.sh status                 # show current config
-#   ./install.sh uninstall              # remove config + env file
-#
-# ── Subagents ─────────────────────────────────────────────────────────────────
-# Subagents are OFF by default. Current Codex releases (>=0.144) wrap subagent
-# tools in a `type: "namespace"` wire format that non-OpenAI providers can't
-# resolve, causing "unsupported call: spawn_agent" errors (upstream #32318,
-# #26977, #17598). The fix (PR #29602) is not yet merged.
-#
-# To use subagents, install the legacy Codex 0.132.0 which uses the older
-# multi-agent v1 config with plain tool names:
-#
-#   ./install.sh --subagents --gateway-url ... --api-key ...
-#
-# This pins `codex@0.132.0` and writes the legacy agents config:
-#
-#   [features]
-#   multi_agent = true
-#
-#   [agents]
-#   max_threads = 4
-#   max_depth = 1
-#   interrupt_message = true
-#
-# ── What this does under the hood ────────────────────────────────────────────
-# Equivalent manual setup (writes ~/.codex/config.toml + model catalog + env):
-#
-#   export SUBCONSCIOUS_API_KEY=sk-gw-...
-#   cat > ~/.codex/model-catalog.json <<'EOF'
-#   { "models": [{ ... }] }
-#   EOF
-#
-#   cat > ~/.codex/config.toml <<'EOF'
-#   model = "subconscious/glm-5.2"
-#   model_provider = "subconscious"
-#   model_catalog_json = "~/.codex/model-catalog.json"
-#   web_search = "disabled"
-#
-#   [model_providers.subconscious]
-#   name = "Subconscious Gateway"
-#   base_url = "https://your-gateway.example/v1"
-#   wire_api = "responses"
-#   env_key = "SUBCONSCIOUS_API_KEY"
-#   stream_idle_timeout_ms = 300000
-#   EOF
-#   codex
-#
-# Codex natively sends thread-id / session-id / x-codex-turn-metadata headers
-# so the gateway can group requests into Conversations.
-#
-# Also installs ~/.codex/hooks.json + hook script that report PreCompact /
-# PostCompact to /v1/agent-hooks so summarization turns (local compaction path
-# for custom providers) are billed as compaction. After install, trust the
-# hooks in Codex with /hooks (or --dangerously-bypass-hook-trust for one-offs).
-# Docs: https://developers.openai.com/codex/hooks
+#   subc codex install     # merge hooks
+#   subc codex status
+#   subc codex uninstall   # strip only Subconscious hook entries
 # ─────────────────────────────────────────────────────────────────────────────
 
 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}"
+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
 
+# shellcheck source=hooks-lib.sh
+source "${SCRIPT_DIR}/hooks-lib.sh"
+
 COMMAND="install"
 GATEWAY_URL="${GATEWAY_URL:-}"
 API_KEY="${CODEX_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.2}"
-SUBAGENTS=false
-EXTERNAL_TOOLS="${CODEX_EXTERNAL_TOOLS:-false}"
-MAX_CONCURRENT_SUBAGENTS="${MAX_CONCURRENT_SUBAGENTS:-4}"
-CODEX_CONTEXT_WINDOW="${CODEX_CONTEXT_WINDOW:-5000000}"
-# Empty means "same as context window" after CLI/env resolution.
-CODEX_MAX_CONTEXT_WINDOW="${CODEX_MAX_CONTEXT_WINDOW:-}"
-CODEX_AUTO_COMPACT_TOKEN_LIMIT="${CODEX_AUTO_COMPACT_TOKEN_LIMIT:-4500000}"
-CODEX_REASONING_EFFORT="${CODEX_REASONING_EFFORT:-max}"
-
-# Codex version that supports the legacy multi-agent v1 config (plain tool names).
-SUBAGENT_CODEX_VERSION="0.132.0"
 
 usage() {
   cat <<'EOF'
 Usage:
-  install.sh [install] --gateway-url URL --api-key KEY [--model MODEL]
-                         [--subagents] [--max-concurrent-subagents N]
-                         [--context-window N] [--max-context-window N]
-                         [--auto-compact-token-limit N]
-  install.sh use [-- CODEX_ARGS...]
-  install.sh env
-  install.sh unset
-  install.sh uninstall
-  install.sh status
-
-`install` is the default subcommand and may be omitted.
-
-Commands:
-  install     Write ~/.codex/config.toml + ~/.codex/subconscious.env
-  use         Source the env file and exec codex (pass -- followed by codex args)
-  env         Print export lines for sourcing: source <(./install.sh env)
-  unset       Print unset lines for sourcing: source <(./install.sh unset)
-  uninstall   Remove the config and env file
-  status      Show current configuration
+  subc codex install [--gateway-url URL] [--api-key KEY]
+  subc codex status
+  subc codex uninstall
 
-Options:
-  --gateway-url URL            Gateway origin (e.g. https://gateway.example)
-  --api-key KEY                Gateway API key (sk-gw-...)
-  --model MODEL                Model name (default: subconscious/glm-5.2)
-  --context-window N           Catalog context_window (default: 5000000 / CODEX_CONTEXT_WINDOW)
-  --max-context-window N       Catalog max_context_window (default: same as context window)
-  --auto-compact-token-limit N Catalog auto_compact_token_limit (default: 4500000)
-  --reasoning-effort LEVEL     Reasoning effort: none, low, medium, high, or max
-                               (default: max)
-  --subagents                  Enable subagents (pins codex@0.132.0, writes legacy
-                               multi-agent v1 config with plain tool names)
-  --external-tools             Enable Codex apps/plugins (off by default to stay
-                               below the gateway's 128-tool request limit)
-  --max-concurrent-subagents N Max concurrent subagent threads (default: 4,
-                               only used with --subagents)
+Merges Subconscious compaction hooks into ~/.codex/hooks.json. Does not write
+config.toml. Launch Codex with subc codex.
 EOF
 }
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
-    install|use|env|unset|uninstall|status)
+    install|uninstall|status)
       COMMAND="$1"
       shift
       ;;
@@ -152,38 +51,9 @@ while [[ $# -gt 0 ]]; do
       shift 2
       ;;
     --model)
-      MODEL="${2:-}"
-      shift 2
-      ;;
-    --context-window)
-      CODEX_CONTEXT_WINDOW="${2:-}"
       shift 2
       ;;
-    --max-context-window)
-      CODEX_MAX_CONTEXT_WINDOW="${2:-}"
-      shift 2
-      ;;
-    --auto-compact-token-limit)
-      CODEX_AUTO_COMPACT_TOKEN_LIMIT="${2:-}"
-      shift 2
-      ;;
-    --reasoning-effort)
-      CODEX_REASONING_EFFORT="${2:-}"
-      shift 2
-      ;;
-    --subagents)
-      SUBAGENTS=true
-      shift
-      ;;
-    --external-tools)
-      EXTERNAL_TOOLS=true
-      shift
-      ;;
-    --max-concurrent-subagents)
-      MAX_CONCURRENT_SUBAGENTS="${2:-}"
-      shift 2
-      ;;
-    -h|--help)
+    -h|--help|help)
       usage
       exit 0
       ;;
@@ -192,333 +62,21 @@ while [[ $# -gt 0 ]]; do
       break
       ;;
     *)
-      echo "unknown argument: $1" >&2
+      echo "unknown argument: $1 (launch options belong on subc codex, not subc codex install)" >&2
       usage >&2
       exit 1
       ;;
   esac
 done
 
-# Default max_context_window to context_window when unset.
-CODEX_MAX_CONTEXT_WINDOW="${CODEX_MAX_CONTEXT_WINDOW:-${CODEX_CONTEXT_WINDOW}}"
-case "$CODEX_REASONING_EFFORT" in
-  none|low|medium|high|max) ;;
-  *)
-    echo "error: reasoning effort must be one of: none, low, medium, high, max" >&2
-    exit 1
-    ;;
-esac
-
-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")
-}
-
-# Keep the configured model first while exposing every available model in the
-# persistent Codex catalog. The CLI injects the registry list; this fallback is
-# used when the runbook is invoked directly.
-add_supported_model "$MODEL"
-while IFS= read -r model_id; do
-  add_supported_model "$model_id"
-done <<< "${SUBCONSCIOUS_MODELS:-$DEFAULT_SUBCONSCIOUS_MODELS}"
-
-write_model_catalog() {
-  local catalog_file="$1" model_id index=0
-  {
-    printf '{\n  "models": [\n'
-    for model_id in "${SUPPORTED_MODELS[@]}"; do
-      if [[ "$index" -gt 0 ]]; then
-        printf ',\n'
-      fi
-      cat <<EOF
-    {
-      "slug": "${model_id}",
-      "display_name": "${model_id}",
-      "description": "Subconscious API Gateway model ${model_id}",
-      "context_window": ${CODEX_CONTEXT_WINDOW},
-      "max_context_window": ${CODEX_MAX_CONTEXT_WINDOW},
-      "auto_compact_token_limit": ${CODEX_AUTO_COMPACT_TOKEN_LIMIT},
-      "effective_context_window_percent": 95,
-      "supported_reasoning_levels": [],
-      "shell_type": "shell_command",
-      "visibility": "list",
-      "supported_in_api": true,
-      "priority": 0,
-      "availability_nux": null,
-      "upgrade": null,
-      "base_instructions": "You are Codex, a coding agent.",
-      "supports_reasoning_summaries": false,
-      "support_verbosity": false,
-      "default_verbosity": null,
-      "apply_patch_tool_type": "freeform",
-      "truncation_policy": { "mode": "tokens", "limit": 10000 },
-      "supports_parallel_tool_calls": true,
-      "experimental_supported_tools": []
-    }
-EOF
-      index=$((index + 1))
-    done
-    printf '\n  ]\n}\n'
-  } >"$catalog_file"
-}
-
-CODEX_DIR="${HOME}/.codex"
-CONFIG_TOML="${CODEX_DIR}/config.toml"
-ENV_FILE="${CODEX_DIR}/subconscious.env"
-HOOKS_ENV_FILE="${CODEX_DIR}/subconscious-hooks.env"
-HOOK_DST="${CODEX_DIR}/subconscious-hook.sh"
-HOOKS_JSON="${CODEX_DIR}/hooks.json"
-CATALOG_FILE="${CODEX_DIR}/model-catalog.json"
-MARKER='model_provider = "subconscious"'
-
-write_config() {
-  mkdir -p "$CODEX_DIR"
-  local base_url="${GATEWAY_URL%/}/v1"
-
-  # Codex does not load custom model metadata from config.toml — it needs a
-  # JSON catalog pointed to by the root-level `model_catalog_json` key.
-  # Without this, Codex prints "Model metadata not found" and falls back to
-  # degraded defaults. The catalog is a replacement, not a merge, so include
-  # the complete Subconscious model list.
-  write_model_catalog "$CATALOG_FILE"
-
-  # Write config.toml. When --subagents is set, write the legacy multi-agent v1
-  # config that uses plain tool names (not namespace wrappers), which the model
-  # worker can actually resolve. Otherwise, omit the [agents] block entirely so
-  # Codex uses its defaults (subagents off for custom providers).
-  if [[ "$SUBAGENTS" == "true" ]]; then
-    cat >"$CONFIG_TOML" <<EOF
-model = "${MODEL}"
-model_provider = "subconscious"
-model_catalog_json = "${CATALOG_FILE}"
-model_reasoning_effort = "${CODEX_REASONING_EFFORT}"
-web_search = "disabled"
-
-[features]
-multi_agent = true
-apps = ${EXTERNAL_TOOLS}
-plugins = ${EXTERNAL_TOOLS}
-
-[apps._default]
-enabled = ${EXTERNAL_TOOLS}
-
-[agents]
-max_threads = ${MAX_CONCURRENT_SUBAGENTS}
-max_depth = 1
-interrupt_message = true
-
-[model_providers.subconscious]
-name = "Subconscious Gateway"
-base_url = "${base_url}"
-wire_api = "responses"
-env_key = "SUBCONSCIOUS_API_KEY"
-stream_idle_timeout_ms = 300000
-EOF
-  else
-    cat >"$CONFIG_TOML" <<EOF
-model = "${MODEL}"
-model_provider = "subconscious"
-model_catalog_json = "${CATALOG_FILE}"
-model_reasoning_effort = "${CODEX_REASONING_EFFORT}"
-web_search = "disabled"
-
-[features]
-apps = ${EXTERNAL_TOOLS}
-plugins = ${EXTERNAL_TOOLS}
-
-[apps._default]
-enabled = ${EXTERNAL_TOOLS}
-
-[model_providers.subconscious]
-name = "Subconscious Gateway"
-base_url = "${base_url}"
-wire_api = "responses"
-env_key = "SUBCONSCIOUS_API_KEY"
-stream_idle_timeout_ms = 300000
-EOF
-  fi
-
-  umask 077
-  cat >"$ENV_FILE" <<EOF
-# Generated by ol-runbook/coding-agents/codex/install.sh — do not commit secrets.
-export SUBCONSCIOUS_API_KEY='${API_KEY}'
-export SUBCONSCIOUS_GATEWAY_URL='${GATEWAY_URL%/}'
-EOF
-  chmod 600 "$ENV_FILE"
-
-  # Separate hooks env so the hook script can source it without depending on
-  # whether the CLI process inherited subconscious.env.
-  cat >"$HOOKS_ENV_FILE" <<EOF
-# Generated by ol-runbook/coding-agents/codex/install.sh — do not commit secrets.
-export SUBCONSCIOUS_GATEWAY_URL='${GATEWAY_URL%/}'
-export SUBCONSCIOUS_API_KEY='${API_KEY}'
-EOF
-  chmod 600 "$HOOKS_ENV_FILE"
-}
-
-write_hooks() {
-  if [[ ! -f "$HOOK_SRC" || ! -f "$HOOKS_TEMPLATE" ]]; then
-    echo "warning: codex hook sources missing; skipping compaction hooks" >&2
-    return
-  fi
-  mkdir -p "$CODEX_DIR"
-  cp "$HOOK_SRC" "$HOOK_DST"
-  chmod +x "$HOOK_DST"
-  sed "s|HOOK_SH_PATH|${HOOK_DST}|g" "$HOOKS_TEMPLATE" >"$HOOKS_JSON"
-}
-
-print_env_exports() {
-  if [[ ! -f "$ENV_FILE" ]]; then
-    echo "env file not found: $ENV_FILE" >&2
-    echo "run: ./install.sh --gateway-url URL --api-key KEY" >&2
-    return 1
-  fi
-  cat "$ENV_FILE"
-}
-
-print_env_unsets() {
-  cat <<'EOF'
-unset SUBCONSCIOUS_API_KEY
-unset SUBCONSCIOUS_GATEWAY_URL
-EOF
-}
-
-uninstall_config() {
-  if [[ -f "$CONFIG_TOML" ]] && grep -q "$MARKER" "$CONFIG_TOML" 2>/dev/null; then
-    rm -f "$CONFIG_TOML"
-    echo "Removed $CONFIG_TOML"
-  else
-    echo "No Subconscious Codex config found at $CONFIG_TOML"
-  fi
-  rm -f "$ENV_FILE" "$HOOKS_ENV_FILE" "$HOOK_DST" "$HOOKS_JSON"
-  if [[ -f "$CATALOG_FILE" ]]; then
-    rm -f "$CATALOG_FILE"
-    echo "Removed $CATALOG_FILE"
-  fi
-}
-
-status() {
-  echo "scope: user"
-  echo "codex dir: $CODEX_DIR"
-  echo "config: $CONFIG_TOML"
-  if [[ -f "$CONFIG_TOML" ]] && grep -q "$MARKER" "$CONFIG_TOML" 2>/dev/null; then
-    echo "status: installed"
-    echo "model: $(grep '^model' "$CONFIG_TOML" | head -1 | sed 's/^model = "//;s/"$//')"
-    echo "base_url: $(grep 'base_url' "$CONFIG_TOML" | sed 's/^base_url = "//;s/"$//')"
-    if grep -q '^\[agents\]' "$CONFIG_TOML" 2>/dev/null; then
-      echo "subagents: enabled (legacy multi-agent v1)"
-      local maxt
-      maxt="$(awk -F' *= *' '/^max_threads *=/{print $2}' "$CONFIG_TOML")"
-      echo "  max_threads: ${maxt:-?}"
-    else
-      echo "subagents: disabled (codex defaults)"
-    fi
-  else
-    echo "status: not installed"
-  fi
-  if [[ -f "$ENV_FILE" ]]; then
-    echo "env: $ENV_FILE (present)"
-  else
-    echo "env: missing"
-  fi
-  if [[ -f "$HOOKS_JSON" && -x "$HOOK_DST" ]]; then
-    echo "compaction hooks: $HOOKS_JSON (installed)"
-  else
-    echo "compaction hooks: not installed"
-  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_config
-    write_hooks
-    echo "Installed Subconscious Codex config at $CONFIG_TOML"
-    echo "  gateway: $GATEWAY_URL"
-    echo "  model:   $MODEL"
-    if [[ -f "$HOOKS_JSON" ]]; then
-      echo "  compaction hooks: $HOOKS_JSON"
-      echo ""
-      echo "  Trust the new hooks in Codex before they run:"
-      echo "    open /hooks in the CLI, or pass --dangerously-bypass-hook-trust for one-offs"
-      echo "    Docs: https://developers.openai.com/codex/hooks"
-    fi
-    if [[ "$SUBAGENTS" == "true" ]]; then
-      echo "  subagents: ENABLED (codex@${SUBAGENT_CODEX_VERSION}, max ${MAX_CONCURRENT_SUBAGENTS} threads)"
-      echo ""
-      echo "  NOTE: Subagent mode pins codex@${SUBAGENT_CODEX_VERSION}."
-      echo "  Install it with:  npm install -g @openai/codex@${SUBAGENT_CODEX_VERSION}"
-      echo "  Then launch with: ./install.sh use"
-    else
-      echo "  subagents: disabled (default for custom providers)"
-    fi
-    echo ""
-    echo "Launch codex:"
-    echo "  ./install.sh use"
-    echo "  ./install.sh use -- --resume"
-    echo ""
-    echo "Or source env into your current shell:"
-    echo "  source <(./install.sh env)"
-    ;;
-  use)
-    if [[ ! -f "$ENV_FILE" ]]; then
-      echo "env file not found: $ENV_FILE" >&2
-      echo "run: ./install.sh --gateway-url URL --api-key KEY" >&2
-      exit 1
-    fi
-    # shellcheck disable=SC1090
-    source "$ENV_FILE"
-    # If subagents are enabled, ensure the pinned legacy version is installed.
-    if [[ "$SUBAGENTS" == "true" ]]; then
-      if ! command -v codex >/dev/null 2>&1; then
-        echo "codex CLI not found in PATH" >&2
-        echo "Install the pinned subagent version:" >&2
-        echo "  npm install -g @openai/codex@${SUBAGENT_CODEX_VERSION}" >&2
-        exit 1
-      fi
-      local_version="$(codex --version 2>/dev/null | head -1 | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' || echo "")"
-      if [[ "$local_version" != "$SUBAGENT_CODEX_VERSION" ]]; then
-        echo "WARNING: codex ${local_version:-unknown} is installed, but subagents need ${SUBAGENT_CODEX_VERSION}." >&2
-        echo "  npm install -g @openai/codex@${SUBAGENT_CODEX_VERSION}" >&2
-        echo "  (or remove --subagents from your config to use the latest codex without subagents)" >&2
-      fi
-    else
-      if ! command -v codex >/dev/null 2>&1; then
-        echo "codex CLI not found in PATH" >&2
-        exit 1
-      fi
-    fi
-    exec codex "$@"
-    ;;
-  env)
-    print_env_exports
-    ;;
-  unset)
-    print_env_unsets
+    codex_ensure_hooks strict
     ;;
   uninstall)
-    uninstall_config
-    echo "To unset env in your current shell: source <(./install.sh unset)"
+    codex_uninstall_hooks
     ;;
   status)
-    status
+    codex_hooks_status
     ;;
 esac

package/bin/runbook/codex/run.sh

@@ -23,7 +23,7 @@
 #   ./run.sh --external-tools          # include Codex apps/plugins (may exceed gateway tool limits)
 #
 # Config: copy ../env.example to ../.env and edit. .env is gitignored.
-# All agents share one coding-agents/.env file.
+# Profile env is injected by subc. A sibling .env is only used when SUBC_ENV_FILE is unset.
 #
 # Or source it to just export the env:
 #   source run.sh
@@ -32,8 +32,8 @@ 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}"
+# 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
 
@@ -191,27 +191,11 @@ fi
 export SUBCONSCIOUS_API_KEY="$API_KEY"
 export SUBCONSCIOUS_GATEWAY_URL="${GATEWAY_URL%/}"
 
-# Ensure compaction hooks are present for ephemeral runs too. Codex discovers
-# ~/.codex/hooks.json alongside config layers; trust them once via /hooks.
+# Merge compaction hooks without replacing ~/.codex/hooks.json or config.toml.
 HOOK_SRC="${SCRIPT_DIR}/hook.sh"
-HOOKS_TEMPLATE="${SCRIPT_DIR}/hooks.json"
-CODEX_DIR="${HOME}/.codex"
-HOOK_DST="${CODEX_DIR}/subconscious-hook.sh"
-HOOKS_JSON="${CODEX_DIR}/hooks.json"
-HOOKS_ENV_FILE="${CODEX_DIR}/subconscious-hooks.env"
-if [[ -f "$HOOK_SRC" && -f "$HOOKS_TEMPLATE" ]]; then
-  mkdir -p "$CODEX_DIR"
-  cp "$HOOK_SRC" "$HOOK_DST"
-  chmod +x "$HOOK_DST"
-  sed "s|HOOK_SH_PATH|${HOOK_DST}|g" "$HOOKS_TEMPLATE" >"$HOOKS_JSON"
-  umask 077
-  cat >"$HOOKS_ENV_FILE" <<EOF
-# Generated by ol-runbook/coding-agents/codex/run.sh — do not commit secrets.
-export SUBCONSCIOUS_GATEWAY_URL='${GATEWAY_URL%/}'
-export SUBCONSCIOUS_API_KEY='${API_KEY}'
-EOF
-  chmod 600 "$HOOKS_ENV_FILE"
-fi
+# shellcheck source=hooks-lib.sh
+source "${SCRIPT_DIR}/hooks-lib.sh"
+codex_ensure_hooks best-effort || true
 
 # Write a temp model catalog so Codex doesn't print "model metadata not found".
 # This is the one thing that can't be passed via -c flags.

package/bin/runbook/copilot/install.sh

@@ -66,8 +66,8 @@ 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}"
+# 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
 
@@ -99,9 +99,9 @@ MARKER="subconscious-hook.sh"
 usage() {
   cat <<'EOF'
 Usage:
-  install.sh [install] [--gateway-url URL] [--api-key KEY] [--model MODEL]
-  install.sh uninstall
-  install.sh status
+  subc copilot install [--gateway-url URL] [--api-key KEY] [--model MODEL]
+  subc copilot uninstall
+  subc copilot status
 
 `install` is the default subcommand. It writes a "Subconscious Gateway"
 Custom Endpoint provider into VS Code's user-wide chatLanguageModels.json
@@ -112,10 +112,10 @@ requires it to be entered through its UI (the script writes a stable
 ${input:chat.lm.secret.*} reference into chatLanguageModels.json, and you
 paste the key once via Manage Language Models).
 
-The API key for the hooks is read from coding-agents/.env or --api-key and
+The API key for the hooks is read from the profile env or --api-key and
 stored in ~/.copilot/subconscious-hooks.env (mode 600).
 
-Reads GATEWAY_URL, API_KEY, and MODEL from the shared coding-agents/.env by
+Reads GATEWAY_URL, API_KEY, and MODEL from the profile env by
 default. Restart VS Code after install.
 
 Options:
@@ -354,7 +354,7 @@ uninstall_config() {
 write_hooks_env() {
   umask 077
   cat >"$ENV_FILE" <<EOF
-# Generated by ol-runbook/coding-agents/copilot/install.sh — do not commit secrets.
+# Generated by subc — do not commit secrets.
 export SUBCONSCIOUS_GATEWAY_URL='${GATEWAY_URL}'
 export SUBCONSCIOUS_API_KEY='${API_KEY}'
 EOF
@@ -434,6 +434,7 @@ case "$COMMAND" in
     USER_DIR="$(detect_vscode_dir)"
     WRITTEN="$(write_config "$USER_DIR")"
     echo "Installed Subconscious Copilot provider into $WRITTEN"
+    echo "Gateway base URL: ${GATEWAY_URL%/}/v1"
     install_hook_script
     write_hooks_env
     write_hooks_json