subconscious-cli 4.0.17 → 4.0.18

package/README.md

@@ -34,8 +34,9 @@ subc <agent> uninstall
 
 Running `subc` with no arguments in a terminal opens the native Go TUI. Use
 the arrow keys and Enter to launch agents or manage the active profile, `p` to
-switch profiles, and `q` to quit. The menu includes dedicated **Create profile**,
-**Set default model**, **Set subagent model**, and **Update base URL** actions.
+switch profiles, and `q` to quit. The menu includes dedicated **Usage**,
+**Create profile**, **Set default model**, **Set subagent model**,
+**Update base URL**, and **Update platform URL** actions.
 Model and URL changes are validated and saved to the active profile without
 leaving the TUI.
 `subc help` and `subc --help` continue to print script-friendly command help.
@@ -161,7 +162,7 @@ DeepSeek Harness context and output settings used by the packaged runbook script
 subc config                         # list every profile and its file path
 subc -p staging config create      # create a profile with default settings
 subc -p staging config              # print that path and env file
-subc -p staging config --model subconscious/glm-5.2
+subc -p staging config --model subconscious/glm-5.3-marathon
 subc -p staging config --model UNSET
 subc -p staging config --subagent-model subconscious/deepseek-v4-flash-marathon
 subc -p staging config --subagent-model UNSET
@@ -197,7 +198,7 @@ Named profiles work like AWS CLI profiles:
 subc -p staging config \
   --gateway-url https://staging.example \
   --api-key sk-staging-... \
-  --model subconscious/glm-5.2
+  --model subconscious/glm-5.3-marathon
 
 subc -p staging claude
 subc -p staging cursor install
@@ -216,7 +217,8 @@ that request fails, it falls back to the public `/v1/models` fleet list, then
 to the models packaged with the CLI:
 
 ```text
-subconscious/glm-5.2 (default)
+subconscious/glm-5.3-marathon (default)
+subconscious/glm-5.2
 subconscious/tim-qwen3.6-27b
 subconscious/deepseek-v4-flash-marathon
 ```
@@ -225,10 +227,10 @@ Select a model per run, save it in the current profile, or override it through
 the environment:
 
 ```bash
-subc codex --model subconscious/glm-5.2
+subc codex --model subconscious/glm-5.3-marathon
 subc config --model subconscious/deepseek-v4-flash-marathon
 subc config --subagent-model subconscious/tim-qwen3.6-27b
-export SUBCONSCIOUS_MODEL=subconscious/glm-5.2
+export SUBCONSCIOUS_MODEL=subconscious/glm-5.3-marathon
 ```
 
 Every launch and install fetches the same live catalog without caching. Codex,
@@ -275,6 +277,9 @@ also maintains `~/.subconscious/config.json`.
 subc login
 subc update-key sk-new-key-...
 subc update-url https://api.subconscious.dev
+subc update-platform-url https://platform.subconscious.dev
+subc usage
+subc usage --json
 subc whoami
 subc logout
 ```
@@ -305,6 +310,21 @@ updated automatically as well.
 `SUBCONSCIOUS_BASE_URL` continues to take precedence when set. A configured
 `CLAUDE_GATEWAY_URL` remains a Claude-specific override.
 
+`subc update-platform-url <platform-url>` validates the URL and saves
+`PLATFORM_URL` in the active profile. Login, `whoami`, and `usage` call this
+host. Production defaults to `https://platform.subconscious.dev`:
+
+```bash
+subc update-platform-url https://platform.subconscious.dev
+subc config --platform-url http://localhost:3000
+```
+
+`SUBCONSCIOUS_URL` overrides the saved profile value for local development.
+
+`subc usage` fetches billing mode, daily token allowance, credit balance,
+overage, and per-model consumption from `GET /api/v1/usage` on the resolved
+platform host. Pass `--json` for machine-readable output.
+
 `SUBCONSCIOUS_API_KEY` takes precedence over profile and saved config keys,
 which is useful for CI and temporary sessions. `subc logout` clears the
 selected profile's shared key while preserving its non-secret runbook settings;

package/bin/auth.js

@@ -34,9 +34,12 @@ const LEGACY_CONFIG_FILE = CONFIG_OVERRIDE
 // Defaults to the platform host. Developers set SUBCONSCIOUS_URL for local dev.
 export const DEFAULT_PLATFORM_URL = 'https://platform.subconscious.dev';
 
-export function getPlatformUrl() {
-  const raw = process.env.SUBCONSCIOUS_URL?.trim() || DEFAULT_PLATFORM_URL;
-  return raw.replace(/\/$/, '');
+export function getPlatformUrl(profile) {
+  const fromEnv = process.env.SUBCONSCIOUS_URL?.trim();
+  if (fromEnv) return fromEnv.replace(/\/$/, '');
+  const fromProfile = profile?.values?.PLATFORM_URL?.trim();
+  if (fromProfile) return fromProfile.replace(/\/$/, '');
+  return DEFAULT_PLATFORM_URL;
 }
 
 // Login callback CORS. After the marketing/platform split, /cli/auth lives on
@@ -323,7 +326,7 @@ export async function loginCommand(_argv = [], options = {}) {
   );
   console.log();
 
-  const platformUrl = getPlatformUrl();
+  const platformUrl = getPlatformUrl(options.profile);
   const loginStatus = await probeLoginPage(platformUrl);
   if (isLoginMissing(loginStatus)) {
     printLoginUpgradeWarning();
@@ -459,7 +462,7 @@ export async function whoamiCommand(_argv = [], options = {}) {
 
   // Validate the key against the server; falls back to offline display if unreachable
   try {
-    const res = await fetch(`${getPlatformUrl()}/api/cli/whoami`, {
+    const res = await fetch(`${getPlatformUrl(options.profile)}/api/cli/whoami`, {
       headers: { Authorization: `Bearer ${key}` },
       signal: AbortSignal.timeout(5000),
     });

package/bin/cli.js

@@ -37,12 +37,14 @@ import {
   resolvedModelSetting,
   RUNBOOK_DEFAULTS,
   SUPPORTED_MODELS as PACKAGED_MODELS,
+  updatePlatformUrlCommand,
   updateUrlCommand,
   validateProfileName,
 } from './profiles.js';
 import { resolveModelCatalog } from './models.js';
 import { showUpdateNotice } from './update-check.js';
 import { runTui } from './tui.js';
+import { printUsageHelp, usageCommand } from './usage.js';
 
 function isHelpArg(arg) {
   return arg === 'help' || arg === '-h' || arg === '--help';
@@ -63,8 +65,10 @@ function printHelp() {
     ${c.cyan}login${c.reset}        Authenticate and save your API key
     ${c.cyan}update-key${c.reset}   Replace the selected profile's API key
     ${c.cyan}update-url${c.reset}   Update the active profile's gateway URL automatically
+    ${c.cyan}update-platform-url${c.reset}  Update the active profile's platform URL
     ${c.cyan}logout${c.reset}       Remove saved credentials
     ${c.cyan}whoami${c.reset}       Show current authentication status
+    ${c.cyan}usage${c.reset}        Show billing, quota, and model usage
     ${c.cyan}upgrade${c.reset}      Upgrade this CLI to the latest version
 
   ${c.bold}Profiles${c.reset}
@@ -88,6 +92,8 @@ ${agents}
     ${c.dim}$${c.reset} subc config help
     ${c.dim}$${c.reset} subc -p staging config
     ${c.dim}$${c.reset} subc config edit vim
+    ${c.dim}$${c.reset} subc usage
+    ${c.dim}$${c.reset} subc usage --json
     ${c.dim}$${c.reset} subc claude
     ${c.dim}$${c.reset} subc claude help
     ${c.dim}$${c.reset} subc cursor install
@@ -149,6 +155,22 @@ Usage:
   subc update-url help
 
 Update the active profile's gateway URL.
+`,
+  'update-platform-url': `
+Usage:
+  subc update-platform-url <platform-url>
+  subc update-platform-url help
+
+Update the active profile's platform URL for login, whoami, and usage.
+`,
+  usage: `
+Usage:
+  subc usage
+  subc -p NAME usage
+  subc usage --json
+  subc usage help
+
+Show billing mode, daily token allowance, credit balance, and per-model usage.
 `,
   models: `
 Usage:
@@ -351,6 +373,25 @@ async function main() {
     return;
   }
 
+  if (command === 'update-platform-url') {
+    if (isHelpArg(args[1])) {
+      console.log(COMMAND_HELP['update-platform-url']);
+      return;
+    }
+    await updatePlatformUrlCommand(args.slice(1), { profileName });
+    return;
+  }
+
+  if (command === 'usage') {
+    if (isHelpArg(args[1])) {
+      printUsageHelp();
+      return;
+    }
+    const profile = await loadProfile(profileName);
+    await usageCommand(args.slice(1), { profile, profileName });
+    return;
+  }
+
   const agent = resolveAgent(command);
   if (agent) {
     const agentArgs = args.slice(1);

package/bin/profiles.js

@@ -76,6 +76,12 @@ const SETTINGS = {
     type: 'url',
     required: true,
   },
+  PLATFORM_URL: {
+    key: 'PLATFORM_URL',
+    label: 'Platform URL',
+    description: 'Subconscious platform origin for login, whoami, and usage.',
+    type: 'url',
+  },
   API_KEY: {
     key: 'API_KEY',
     label: 'Shared API key',
@@ -711,7 +717,7 @@ Usage:
   subc config edit [vim|nano]
   subc -p NAME config edit [vim|nano]
   subc config [show|path|list|create|delete]
-              [--gateway-url URL] [--api-key KEY]
+              [--gateway-url URL] [--platform-url URL] [--api-key KEY]
               [--model MODEL|UNSET]
               [--subagent-model MODEL|UNSET]
 
@@ -757,6 +763,7 @@ export async function configCommand(argv, profileName = DEFAULT_PROFILE, options
       action = arg === 'interactive' ? 'edit' : arg;
     } else if (
       arg === '--gateway-url' ||
+      arg === '--platform-url' ||
       arg === '--api-key' ||
       arg === '--model' ||
       arg === '--subagent-model'
@@ -765,6 +772,7 @@ export async function configCommand(argv, profileName = DEFAULT_PROFILE, options
       if (!value) throw new Error(`${arg} requires a value`);
       const key = {
         '--gateway-url': 'GATEWAY_URL',
+        '--platform-url': 'PLATFORM_URL',
         '--api-key': 'API_KEY',
         '--model': 'MODEL',
         '--subagent-model': 'CLAUDE_CODE_SUBAGENT_MODEL',
@@ -784,7 +792,7 @@ export async function configCommand(argv, profileName = DEFAULT_PROFILE, options
   if (action === 'edit') {
     if (Object.keys(updates).length) {
       throw new Error(
-        'config edit cannot be combined with --gateway-url, --api-key, --model, or --subagent-model',
+        'config edit cannot be combined with --gateway-url, --platform-url, --api-key, --model, or --subagent-model',
       );
     }
     await editProfile(profileName, editor);
@@ -855,27 +863,35 @@ export function modelsCommand(models = SUPPORTED_MODELS, options = {}) {
   console.log();
 }
 
-export async function updateUrlCommand(argv = [], options = {}) {
-  if (argv.length !== 1 || !argv[0]?.trim()) {
-    throw new Error('Usage: subc update-url <gateway-url>');
+export function validateOriginUrl(rawUrl, label = 'URL') {
+  const normalized = String(rawUrl ?? '').trim().replace(/\/+$/, '');
+  if (!normalized) {
+    throw new Error(`${label} cannot be blank`);
   }
-
-  const gatewayUrl = argv[0].trim().replace(/\/+$/, '');
   let parsed;
   try {
-    parsed = new URL(gatewayUrl);
+    parsed = new URL(normalized);
   } catch {
-    throw new Error('Gateway URL must be a valid http:// or https:// URL');
+    throw new Error(`${label} must be a valid http:// or https:// URL`);
   }
   if (!['http:', 'https:'].includes(parsed.protocol) || !parsed.hostname) {
-    throw new Error('Gateway URL must be a valid http:// or https:// URL');
+    throw new Error(`${label} must be a valid http:// or https:// URL`);
   }
   if (parsed.username || parsed.password) {
-    throw new Error('Gateway URL cannot contain embedded credentials');
+    throw new Error(`${label} cannot contain embedded credentials`);
   }
   if (parsed.search || parsed.hash) {
-    throw new Error('Gateway URL cannot contain a query string or fragment');
+    throw new Error(`${label} cannot contain a query string or fragment`);
   }
+  return normalized;
+}
+
+export async function updateUrlCommand(argv = [], options = {}) {
+  if (argv.length !== 1 || !argv[0]?.trim()) {
+    throw new Error('Usage: subc update-url <gateway-url>');
+  }
+
+  const gatewayUrl = validateOriginUrl(argv[0], 'Gateway URL');
 
   const profileName = options.profileName || DEFAULT_PROFILE;
   const profile = await updateProfile(profileName, { GATEWAY_URL: gatewayUrl });
@@ -897,3 +913,24 @@ export async function updateUrlCommand(argv = [], options = {}) {
   }
   console.log();
 }
+
+export async function updatePlatformUrlCommand(argv = [], options = {}) {
+  if (argv.length !== 1 || !argv[0]?.trim()) {
+    throw new Error('Usage: subc update-platform-url <platform-url>');
+  }
+
+  const platformUrl = validateOriginUrl(argv[0], 'Platform URL');
+
+  const profileName = options.profileName || DEFAULT_PROFILE;
+  const profile = await updateProfile(profileName, { PLATFORM_URL: platformUrl });
+
+  console.log(`\n  ${c.green}${c.bold}✓ Platform URL updated.${c.reset}`);
+  console.log(`  ${c.dim}Updated profile automatically: ${profile.path}${c.reset}`);
+  console.log(`  ${c.dim}URL:     ${platformUrl}${c.reset}`);
+  if (process.env.SUBCONSCIOUS_URL?.trim()) {
+    console.log(
+      `\n  ${c.yellow}SUBCONSCIOUS_URL is set and will override this saved URL.${c.reset}`,
+    );
+  }
+  console.log();
+}

package/bin/registry.generated.json

@@ -1,8 +1,9 @@
 {
   "_generated": "Source of truth: agents/registry.json. Do not edit by hand.",
   "defaults": {
-    "model": "subconscious/glm-5.2",
+    "model": "subconscious/glm-5.3-marathon",
     "models": [
+      "subconscious/glm-5.3-marathon",
       "subconscious/glm-5.2",
       "subconscious/tim-qwen3.6-27b",
       "subconscious/deepseek-v4-flash-marathon"
@@ -100,8 +101,8 @@
         "ANTHROPIC_AUTH_TOKEN": "{apiKey}",
         "ANTHROPIC_MODEL": "{model}",
         "ANTHROPIC_SMALL_FAST_MODEL": "{model}",
-        "ANTHROPIC_DEFAULT_OPUS_MODEL": "subconscious/glm-5.2",
-        "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "subconscious/glm-5.2",
+        "ANTHROPIC_DEFAULT_OPUS_MODEL": "subconscious/glm-5.3-marathon",
+        "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "subconscious/glm-5.3-marathon",
         "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",
@@ -219,6 +220,14 @@
                   }
                 },
                 "models": {
+                  "subconscious/glm-5.3-marathon": {
+                    "name": "subconscious/glm-5.3-marathon",
+                    "tools": true,
+                    "limit": {
+                      "context": 5000000,
+                      "output": 65536
+                    }
+                  },
                   "subconscious/glm-5.2": {
                     "name": "subconscious/glm-5.2",
                     "tools": true,

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

@@ -20,9 +20,9 @@
 #
 #   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 ANTHROPIC_MODEL=subconscious/glm-5.3-marathon
+#   export ANTHROPIC_SMALL_FAST_MODEL=subconscious/glm-5.3-marathon
+#   export CLAUDE_CODE_SUBAGENT_MODEL=subconscious/glm-5.3-marathon
 #   export CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=4
 #   export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1
 #   export CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000
@@ -57,7 +57,7 @@ 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_MODEL="subconscious/glm-5.3-marathon"
 DEFAULT_COMPACT_WINDOW="1000000"
 DEFAULT_MAX_CONTEXT_TOKENS="3000000"
 DEFAULT_MAX_CONCURRENT_SUBAGENTS="4"

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

@@ -8,7 +8,7 @@
 #   ./run.sh                         # uses GATEWAY_URL/API_KEY from ../.env
 #   ./run.sh --continue               # pass args through to claude
 #   ./run.sh --compact-window 1000000 -- --continue
-#   ./run.sh --model subconscious/glm-5.2 -p "hi"
+#   ./run.sh --model subconscious/glm-5.3-marathon -p "hi"
 #
 # Config: copy ../env.example to ../.env and edit. .env is gitignored.
 # Profile env is injected by subc. A sibling .env is only used when SUBC_ENV_FILE is unset.
@@ -25,7 +25,7 @@ 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
 
-DEFAULT_MODEL="subconscious/glm-5.2"
+DEFAULT_MODEL="subconscious/glm-5.3-marathon"
 DEFAULT_COMPACT_WINDOW="1000000"
 DEFAULT_MAX_CONTEXT_TOKENS="3000000"
 DEFAULT_MAX_CONCURRENT_SUBAGENTS="4"
@@ -136,7 +136,7 @@ Usage:
 Options (same as install.sh; flags override env for this run):
   --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)
+  --model MODEL          Model name (default: subconscious/glm-5.3-marathon)
   --compact-window N     CLAUDE_CODE_AUTO_COMPACT_WINDOW (default: 1000000; Claude Code clamps to 100000–1000000)
                          See https://code.claude.com/docs/en/env-vars and
                          https://code.claude.com/docs/en/context-window#set-the-auto-compact-window

package/bin/runbook/codex/run.sh

@@ -39,7 +39,7 @@ if [[ -f "$SHARED_ENV" ]]; then set -a; source "$SHARED_ENV"; set +a; fi
 
 GATEWAY_URL="${GATEWAY_URL:-}"
 API_KEY="${CODEX_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.2}"
+MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
 MAX_CONCURRENT_SUBAGENTS="${MAX_CONCURRENT_SUBAGENTS:-4}"
 SUBAGENTS=false
 EXTERNAL_TOOLS="${CODEX_EXTERNAL_TOOLS:-false}"
@@ -102,7 +102,8 @@ case "$CODEX_REASONING_EFFORT" in
     ;;
 esac
 
-DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.3-marathon
+subconscious/glm-5.2
 subconscious/tim-qwen3.6-27b
 subconscious/deepseek-v4-flash-marathon"
 SUPPORTED_MODELS=()

package/bin/runbook/copilot/install.sh

@@ -33,8 +33,8 @@
 #       "apiType": "messages",
 #       "models": [
 #         {
-#           "id": "subconscious/glm-5.2",
-#           "name": "Subconscious GLM 5.2",
+#           "id": "subconscious/glm-5.3-marathon",
+#           "name": "Subconscious GLM 5.3 Marathon",
 #           "url": "https://your-gateway.example/v1/messages",
 #           "toolCalling": true,
 #           "vision": false,
@@ -77,7 +77,7 @@ if [[ -f "$SHARED_ENV" ]]; then set -a; source "$SHARED_ENV"; set +a; fi
 COMMAND="install"
 GATEWAY_URL="${GATEWAY_URL:-}"
 API_KEY="${COPILOT_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.2}"
+MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
 MAX_INPUT_TOKENS="${COPILOT_MAX_INPUT_TOKENS:-5000000}"
 MAX_OUTPUT_TOKENS="${COPILOT_MAX_OUTPUT_TOKENS:-65536}"
 VSCODE_APP="${VSCODE_APP:-}"  # auto-detected: Code | Code - Insiders | VSCodium
@@ -122,7 +122,7 @@ default. Restart VS Code after install.
 Options:
   --gateway-url URL         Gateway origin (default: $GATEWAY_URL from .env)
   --api-key KEY             Gateway API key for hooks (default: $API_KEY from .env)
-  --model MODEL             Model id (default: subconscious/glm-5.2)
+  --model MODEL             Model id (default: subconscious/glm-5.3-marathon)
   --max-input-tokens N      Model context window input tokens (default: 5000000)
   --max-output-tokens N     Model max output tokens (default: 65536)
   --vscode-app APP          Code, Code - Insiders, or VSCodium (auto-detected)
@@ -174,7 +174,8 @@ while [[ $# -gt 0 ]]; do
   esac
 done
 
-DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.3-marathon
+subconscious/glm-5.2
 subconscious/tim-qwen3.6-27b
 subconscious/deepseek-v4-flash-marathon"
 SUPPORTED_MODELS=()

package/bin/runbook/cursor/install.sh

@@ -53,10 +53,11 @@ if [[ -f "$SHARED_ENV" ]]; then set -a; source "$SHARED_ENV"; set +a; fi
 
 GATEWAY_URL="${GATEWAY_URL:-}"
 API_KEY="${CURSOR_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.2}"
+MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
 COMMAND="install"
 
-DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.3-marathon
+subconscious/glm-5.2
 subconscious/tim-qwen3.6-27b
 subconscious/deepseek-v4-flash-marathon"
 

package/bin/runbook/deepseek-harness/run.sh

@@ -6,11 +6,12 @@ set -euo pipefail
 
 GATEWAY_URL="${GATEWAY_URL:-}"
 API_KEY="${DEEPSEEK_HARNESS_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.2}"
+MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
 CONTEXT_WINDOW="${DEEPSEEK_HARNESS_CONTEXT_WINDOW:-5000000}"
 MAX_TOKENS="${DEEPSEEK_HARNESS_MAX_TOKENS:-65536}"
 
-DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.3-marathon
+subconscious/glm-5.2
 subconscious/tim-qwen3.6-27b
 subconscious/deepseek-v4-flash-marathon"
 

package/bin/runbook/opencode/install.sh

@@ -28,15 +28,15 @@
 #           "headers": { "x-subconscious-client": "opencode" }
 #         },
 #         "models": {
-#           "subconscious/glm-5.2": {
-#             "name": "subconscious/glm-5.2",
+#           "subconscious/glm-5.3-marathon": {
+#             "name": "subconscious/glm-5.3-marathon",
 #             "tools": true,
 #             "limit": { "context": 5000000, "output": 65536 }
 #           }
 #         }
 #       }
 #     },
-#     "model": "subconscious/subconscious/glm-5.2"
+#     "model": "subconscious/subconscious/glm-5.3-marathon"
 #   }
 #   EOF
 #   opencode
@@ -63,7 +63,7 @@ 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}"
+MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
 # 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}"
@@ -119,7 +119,8 @@ while [[ $# -gt 0 ]]; do
   esac
 done
 
-DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.3-marathon
+subconscious/glm-5.2
 subconscious/tim-qwen3.6-27b
 subconscious/deepseek-v4-flash-marathon"
 SUPPORTED_MODELS=()

package/bin/runbook/opencode/run.sh

@@ -26,11 +26,12 @@ 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}"
+MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
 CONTEXT_LIMIT="${OPENCODE_CONTEXT_LIMIT:-5000000}"
 OUTPUT_LIMIT="${OPENCODE_OUTPUT_LIMIT:-65536}"
 
-DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.3-marathon
+subconscious/glm-5.2
 subconscious/tim-qwen3.6-27b
 subconscious/deepseek-v4-flash-marathon"
 SUPPORTED_MODELS=()

package/bin/runbook/pi/install.sh

@@ -21,7 +21,7 @@
 #         "apiKey": "sk-gw-...",
 #         "headers": { "x-subconscious-client": "pi" },
 #         "models": [{
-#           "id": "subconscious/glm-5.2",
+#           "id": "subconscious/glm-5.3-marathon",
 #           "contextWindow": 5000000,
 #           "maxTokens": 65536,
 #           "compat": {
@@ -57,7 +57,7 @@ if [[ -f "$SHARED_ENV" ]]; then set -a; source "$SHARED_ENV"; set +a; fi
 COMMAND="install"
 GATEWAY_URL="${GATEWAY_URL:-}"
 API_KEY="${PI_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.2}"
+MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
 CONTEXT_WINDOW="${PI_CONTEXT_WINDOW:-5000000}"
 MAX_TOKENS="${PI_MAX_TOKENS:-65536}"
 
@@ -114,7 +114,8 @@ while [[ $# -gt 0 ]]; do
   esac
 done
 
-DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.3-marathon
+subconscious/glm-5.2
 subconscious/tim-qwen3.6-27b
 subconscious/deepseek-v4-flash-marathon"
 SUPPORTED_MODELS=()

package/bin/runbook/pi/run.sh

@@ -7,7 +7,7 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 GATEWAY_URL="${GATEWAY_URL:-}"
 API_KEY="${PI_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.2}"
+MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
 PI_DIR="${PI_CODING_AGENT_DIR:-${HOME}/.pi/agent}"
 MODELS_JSON="${PI_DIR}/models.json"
 

package/bin/runbook/subconscious-code/run.sh

@@ -5,7 +5,7 @@ set -euo pipefail
 
 GATEWAY_URL="${GATEWAY_URL:-}"
 API_KEY="${SC_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-subconscious/glm-5.2}"
+MODEL="${MODEL:-subconscious/glm-5.3-marathon}"
 
 if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
   echo "error: GATEWAY_URL and API_KEY are required to launch Subconscious Code" >&2

package/bin/tui.js

@@ -5,7 +5,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { agentList } from './agents.js';
-import { getApiKey } from './auth.js';
+import { DEFAULT_PLATFORM_URL, getApiKey, getPlatformUrl } from './auth.js';
 import { resolveModelCatalog } from './models.js';
 import {
   DEFAULT_PROFILE,
@@ -86,6 +86,10 @@ function gatewayFor(profile) {
   ).replace(/\/+$/, '');
 }
 
+function platformFor(profile) {
+  return getPlatformUrl(profile);
+}
+
 async function packageVersion() {
   const pkg = JSON.parse(
     await fs.readFile(new URL('../package.json', import.meta.url), 'utf-8'),
@@ -116,6 +120,7 @@ export async function createTuiState(profileName = DEFAULT_PROFILE, options = {}
   const auth = await getApiKey(activeProfile);
   const requestedModel = selectedModelFor(activeProfile);
   const gatewayUrl = gatewayFor(activeProfile);
+  const platformUrl = platformFor(activeProfile);
   const catalog = await resolveModelCatalog({
     baseUrl: gatewayUrl,
     apiKey: auth?.key,
@@ -137,6 +142,10 @@ export async function createTuiState(profileName = DEFAULT_PROFILE, options = {}
       activeProfile.values.GATEWAY_URL?.trim().replace(/\/+$/, '') ||
       RUNBOOK_DEFAULTS.GATEWAY_URL,
     gatewayOverridden: Boolean(process.env.SUBCONSCIOUS_BASE_URL?.trim()),
+    platformUrl,
+    savedPlatformUrl:
+      activeProfile.values.PLATFORM_URL?.trim().replace(/\/+$/, '') || DEFAULT_PLATFORM_URL,
+    platformOverridden: Boolean(process.env.SUBCONSCIOUS_URL?.trim()),
     modelError: catalog.error?.message || '',
     modelSource: catalog.source,
     agents: agentList().map((agent) => ({

package/bin/usage.js

@@ -0,0 +1,229 @@
+/**
+ * Usage display for `subc usage` — fetches billing/quota from the platform API.
+ */
+
+import { c } from './colors.js';
+import { getApiKey, getPlatformUrl } from './auth.js';
+import { DEFAULT_PROFILE } from './profiles.js';
+import { printLoginUpgradeWarning } from './upgrade.js';
+
+export const USAGE_API_PATH = '/api/v1/usage';
+
+export function formatTokens(value) {
+  const n = Number(value);
+  if (!Number.isFinite(n) || n < 0) return '0';
+  if (n >= 1_000_000_000) {
+    const scaled = n / 1_000_000_000;
+    return `${scaled.toFixed(n % 1_000_000_000 ? 1 : 0)}B`;
+  }
+  if (n >= 1_000_000) {
+    const scaled = n / 1_000_000;
+    return `${scaled.toFixed(n % 1_000_000 ? 1 : 0)}M`;
+  }
+  if (n >= 1_000) return `${Math.round(n / 1_000)}K`;
+  return n.toLocaleString('en-US');
+}
+
+export function formatCurrency(value) {
+  const n = Number(value);
+  if (!Number.isFinite(n)) return '$0.00';
+  const sign = n < 0 ? '-' : '';
+  return `${sign}$${Math.abs(n).toFixed(2)}`;
+}
+
+export function shortModelSlug(slug) {
+  const text = String(slug ?? '').trim();
+  return text.startsWith('subconscious/') ? text.slice('subconscious/'.length) : text;
+}
+
+export function isLegacyUsagePayload(data) {
+  if (!data || typeof data !== 'object') return true;
+  if ('credits' in data && data.plan && typeof data.plan === 'object') return false;
+  return 'dailyTokenCeiling' in data || 'consumedToday' in data || !('plan' in data);
+}
+
+export function meterColor(percentage) {
+  if (percentage >= 100) return c.red;
+  if (percentage >= 80) return c.yellow;
+  return c.green;
+}
+
+export function renderProgressBar(percentage, width = 20) {
+  const pct = Math.max(0, Math.min(100, percentage));
+  const filled = Math.round((pct / 100) * width);
+  const empty = Math.max(0, width - filled);
+  const color = meterColor(pct);
+  return `${color}${'█'.repeat(filled)}${c.dim}${'░'.repeat(empty)}${c.reset}`;
+}
+
+export function formatUsageDisplay(data) {
+  const lines = [];
+  lines.push(`\n  ${c.bold}Subconscious Usage${c.reset}\n`);
+
+  const billingMode = data.billingMode ?? null;
+  const plan = data.plan ?? {};
+  const credits = data.credits ?? {};
+  const models = Array.isArray(data.models) ? data.models : [];
+
+  const planLabel = plan.label || 'No plan';
+  const planStatus = plan.status ? plan.status.replace(/_/g, ' ') : null;
+  const planLine = planStatus ? `${planLabel} · ${planStatus}` : planLabel;
+
+  lines.push(`  ${c.dim}Plan${c.reset}            ${planLine}`);
+  if (billingMode) {
+    lines.push(`  ${c.dim}Billing${c.reset}         ${billingMode}`);
+  }
+
+  const allowance = plan.dailyAllowance;
+  const unlimitedComp = Boolean(plan.isUnlimitedComp);
+
+  if (unlimitedComp) {
+    lines.push('');
+    lines.push(`  ${c.dim}Daily allowance${c.reset}`);
+    lines.push(`  ${c.green}Unlimited${c.reset} ${c.dim}(comp)${c.reset}`);
+  } else if (allowance && allowance.amount > 0) {
+    const consumed = Number(allowance.consumed) || 0;
+    const amount = Number(allowance.amount) || 0;
+    const remaining = Number(allowance.remaining) || 0;
+    const pct = amount > 0 ? Math.min((consumed / amount) * 100, 100) : 0;
+    const overage = Math.max(0, consumed - amount);
+
+    lines.push('');
+    lines.push(`  ${c.dim}Daily allowance${c.reset}`);
+    lines.push(
+      `  ${renderProgressBar(pct)}  ${formatTokens(consumed)} / ${formatTokens(amount)} tokens`,
+    );
+    const resetNote = allowance.resetAt
+      ? `${formatTokens(remaining)} remaining · resets midnight UTC`
+      : `${formatTokens(remaining)} remaining`;
+    lines.push(`  ${c.dim}${resetNote}${c.reset}`);
+    if (overage > 0) {
+      lines.push(`  ${c.yellow}+${formatTokens(overage)} over daily allowance${c.reset}`);
+    }
+  }
+
+  lines.push('');
+  lines.push(
+    `  ${c.dim}Credits${c.reset}         ${formatCurrency(credits.balanceDollars ?? 0)}`,
+  );
+  if (billingMode === 'subscription' || billingMode === 'comp' || allowance) {
+    const overage = Number(credits.overageThisPeriodDollars) || 0;
+    const overageColor = overage > 0 ? c.yellow : c.reset;
+    lines.push(
+      `  ${c.dim}Overage${c.reset}         ${overageColor}${formatCurrency(overage)} this period${c.reset}`,
+    );
+  }
+
+  if (models.length > 0) {
+    lines.push('');
+    lines.push(`  ${c.dim}Models today${c.reset}`);
+    const slugWidth = Math.max(
+      12,
+      ...models.map((model) => shortModelSlug(model.slug).length),
+    );
+    for (const model of models) {
+      const label = shortModelSlug(model.slug).padEnd(slugWidth);
+      lines.push(
+        `    ${label}  ${formatTokens(model.consumedToday ?? 0)}`,
+      );
+    }
+  }
+
+  lines.push('');
+  return lines.join('\n');
+}
+
+export async function fetchUsage(apiKey, platformUrl, fetchImpl = fetch) {
+  const res = await fetchImpl(`${platformUrl.replace(/\/$/, '')}${USAGE_API_PATH}`, {
+    headers: { Authorization: `Bearer ${apiKey}` },
+    signal: AbortSignal.timeout(5000),
+  });
+  return res;
+}
+
+export async function usageCommand(argv = [], options = {}) {
+  const jsonOutput = argv.includes('--json');
+  const profileFlag =
+    options.profileName && options.profileName !== DEFAULT_PROFILE
+      ? `--profile ${options.profileName} `
+      : '';
+
+  const auth = await getApiKey(options.profile);
+  if (!auth) {
+    console.log(`\n  ${c.dim}Not logged in.${c.reset}`);
+    console.log(`  Run ${c.cyan}subc ${profileFlag}login${c.reset} to get started.\n`);
+    return;
+  }
+
+  const platformUrl = getPlatformUrl(options.profile);
+
+  try {
+    const res = await fetchUsage(auth.key, platformUrl);
+
+    if (res.status === 404) {
+      printLoginUpgradeWarning();
+      return;
+    }
+
+    let data;
+    try {
+      data = await res.json();
+    } catch {
+      throw new Error('Platform returned an invalid response');
+    }
+
+    if (!res.ok) {
+      const message = data?.error || `Request failed (${res.status})`;
+      if (res.status === 401) {
+        console.log(`\n  ${c.red}✗ ${message}${c.reset}`);
+        console.log(
+          `  Run ${c.cyan}subc ${profileFlag}logout${c.reset} then ${c.cyan}subc ${profileFlag}login${c.reset} to re-authenticate.\n`,
+        );
+        return;
+      }
+      if (res.status === 403) {
+        console.log(`\n  ${c.red}✗ ${message}${c.reset}\n`);
+        return;
+      }
+      throw new Error(message);
+    }
+
+    if (isLegacyUsagePayload(data)) {
+      console.log(`\n  ${c.yellow}Platform upgrade required.${c.reset}`);
+      console.log(
+        `  ${c.dim}This platform host returns a legacy usage shape. Deploy the latest platform or point PLATFORM_URL at a current host.${c.reset}\n`,
+      );
+      return;
+    }
+
+    if (jsonOutput) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+
+    console.log(formatUsageDisplay(data));
+  } catch (error) {
+    if (error.name === 'TimeoutError' || error.name === 'AbortError') {
+      console.log(`\n  ${c.yellow}Could not reach the platform (timed out).${c.reset}`);
+      console.log(`  ${c.dim}Host: ${platformUrl}${c.reset}\n`);
+      return;
+    }
+    console.error(`\n  ${c.red}${error.message}${c.reset}\n`);
+    process.exitCode = 1;
+  }
+}
+
+export function printUsageHelp() {
+  console.log(`
+Usage:
+  subc usage
+  subc -p NAME usage
+  subc usage --json
+  subc usage help
+
+Show billing mode, daily token allowance, credit balance, and per-model usage
+for the authenticated organization.
+
+  --json   Print the raw platform JSON response
+`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "subconscious-cli",
-  "version": "4.0.17",
+  "version": "4.0.18",
   "description": "CLI for Subconscious — run Subconscious Code, Claude Code, Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi",
   "bin": {
     "subc": "bin/cli.js"