feat: Anthropic API, dual endpoints, self-update, Ctrl+C guard

Feat: Anthropic Messages API
- Full SSE streaming + non-streaming /v1/messages + /messages endpoints
- Tool use blocks with input_json_delta, thinking blocks
- stop_reason mapping (tool-calls -> tool_use, length -> max_tokens)

Feat: self-update
- commandcode-bridge update downloads latest .tgz from GitHub Release
- API cache (1h TTL) in ~/.config/commandcode-bridge/update-cache.json
- Clean existing install before npm install -g (handles npm v11 symlink)
- --version flag prints version from package.json

Feat: TUI
- Dual endpoint header (OpenAI + Anthropic URLs) with [o]/[a] copy
- Ctrl+C opens quit confirmation panel instead of force exit
- Footer, help page, Proxy Config synced with both endpoints

Refactor: server split
- server_controller.dart, openai_handler.dart, anthropic_handler.dart
- Extracted version constant to models/version.dart

Docs: all synced
- README, AGENTS.md, CHANGELOG, INSTALL, ARCHITECTURE, release.yml
- .gitignore updated for runtime artifact

See CHANGELOG.md for full details.

Author: Khip01

.github/workflows/release.yml

@@ -118,6 +118,9 @@ jobs:
             # Run the bridge
             commandcode-bridge run          # TUI mode
             commandcode-bridge run --server # Headless server mode
+
+            # Update when a new release is out
+            commandcode-bridge update
             ```
 
             ### Why not `npm install -g Khip01/commandcode-bridge#${{ github.ref_name }}`?

.gitignore

@@ -9,3 +9,6 @@ stage/
 app-linux
 app-mac
 app-win.exe
+
+# Runtime artifacts (update cache)
+update-cache.json

AGENTS.md

@@ -31,10 +31,12 @@ commandcode-bridge/
 │       ├── main.dart                 # CLI wiring (run, run --server, help)
 │       ├── models/
 │       │   ├── account.dart          # Account + config store (port persist)
-│       │   └── models_db.dart        # 44 models with goAccessible field
+│       │   ├── models_db.dart        # 44 models with goAccessible field
+│       │   └── version.dart          # Bridge version constant
 │       ├── services/
 │       │   ├── api_client.dart       # HTTP client for api.commandcode.ai
-│       │   └── log_store.dart        # JSONL activity log (2000 entries)
+│       │   ├── log_store.dart        # JSONL activity log (2000 entries)
+│       │   └── updater.dart          # Self-update: API cache + download .tgz + npm install -g
 │       ├── server/
 │       │   ├── server_controller.dart # HTTP server + routing
 │       │   ├── openai_handler.dart    # OpenAI-compatible proxy
@@ -71,12 +73,14 @@ commandcode-bridge/
 ```bash
 commandcode-bridge run          Start the bridge in TUI mode
 commandcode-bridge run --server Start the bridge in headless server mode
-commandcode-bridge help         Show this help screen
-commandcode-bridge (no args)    Show this help screen
+commandcode-bridge update       Download and install latest stable release
+commandcode-bridge help         Show help screen
+commandcode-bridge --version    Print version string
+commandcode-bridge (no args)    Show help screen
 commandcode-bridge <invalid>    Show help screen, exit 1
 ```
 
-The npm wrapper (`bin/commandcode-bridge.js`) detects `process.platform`, maps to the correct native binary (`app-linux`, `app-mac`, `app-win.exe`), and spawns it with `stdio: 'inherit'`. All args are forwarded. Once launched, Node.js goes idle and the Dart binary takes full control.
+The npm wrapper (`bin/commandcode-bridge.js`) detects `process.platform`, maps to the correct native binary (`app-linux`, `app-mac`, `app-win.exe`), and spawns it with `stdio: 'inherit'`. `--version` is intercepted in the wrapper (reads `package.json`). All other args (including `update`) are forwarded to Dart. Once launched, Node.js goes idle and the Dart binary takes full control.
 
 ## Distribution
 
@@ -246,8 +250,9 @@ Copy to clipboard via platform-specific tools, fallback to OSC 52:
 - Windows: `clip` -> OSC 52
 
 Copy triggers:
-- `[c]` -- Copy endpoint URL (`http://127.0.0.1:17077/v1`)
-- `[Enter]` on model page -- Copy selected model codename
+- `[o]` — Copy OpenAI endpoint URL (`http://127.0.0.1:17077/v1`)
+- `[a]` — Copy Anthropic endpoint URL (`http://127.0.0.1:17077`)
+- `[Enter]` on model page — Copy selected model codename
 
 ## TUI Pages
 
@@ -309,6 +314,7 @@ run.bat server    # Headless server mode
 npm install -g ./commandcode-bridge-vX.Y.Z.tgz
 commandcode-bridge run          # TUI mode
 commandcode-bridge run --server # Headless server mode
+commandcode-bridge update       # Update to latest stable release
 commandcode-bridge help         # Show help
 ```
 

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-## v1.1.0 (unreleased)
+## v1.1.0 (2026-07-28)
 
 ### Features
 
@@ -13,25 +13,39 @@ All notable changes to this project will be documented in this file.
   - Non-streaming endpoint with proper Anthropic response shape
   - Anthropic Messages protocol -> CC wire format conversion (system, tools, messages)
   - stop_reason mapping: tool-calls -> tool_use, length -> max_tokens
+- Self-update CLI command
+  - `commandcode-bridge update` -- download latest release `.tgz` from GitHub and install via `npm install -g`
+  - `--version` / `-v` flag prints version string
+  - Update cache in `~/.config/commandcode-bridge/update-cache.json` (1-hour TTL, avoids rate limits)
+
+### TUI
+
+- Dual endpoint header: OpenAI (`http://127.0.0.1:{port}/v1`) + Anthropic (`http://127.0.0.1:{port}`)
+- Keymaps: `[o]` copies OpenAI URL, `[a]` copies Anthropic base URL
+- Ctrl+C now opens quit confirmation panel (not force exit)
+  - Quit panel: Y / Enter / second Ctrl+C all confirm quit
+  - Status bar shows red quit hint when panel is open
+- Footer, help page, and Proxy Config (page 6) synced with both endpoints
 
 ### Refactor
 
 - Server code split into three clean files:
-  - `server_controller.dart` — HTTP server, request routing, shared endpoints (/models, /health, /token, /info)
-  - `openai_handler.dart` — OpenAI-compatible handler (streaming + non-streaming)
-  - `anthropic_handler.dart` — Anthropic-compatible handler (streaming + non-streaming)
+  - `server_controller.dart` -- HTTP server, request routing, shared endpoints (/models, /health, /token, /info)
+  - `openai_handler.dart` -- OpenAI-compatible handler (streaming + non-streaming)
+  - `anthropic_handler.dart` -- Anthropic-compatible handler (streaming + non-streaming)
 - Common upstream body builder shared between handlers
 - Removed diagnostic/debug logging; production-level logging only
 - Renamed ProxyServer -> ServerController, extracted handlers to own classes
 - Update OpenCode protocol mapping for production upstream format
 - Fixed config.date field missing from OpenAI handler (was broken after refactor)
+- Extracted version into `lib/src/models/version.dart` constant
 
 ### Docs
 
 - README.md trimmed to preview; detailed docs moved to `docs/`
 - New docs: INSTALL.md, API-REFERENCE.md, TUI.md, ARCHITECTURE.md
 - API-REFERENCE.md covers OpenAI, Anthropic, and Zed client configurations
-- AGENTS.md synced with new file structure and endpoints
+- AGENTS.md synced with new file structure, endpoints, and naming conventions
 
 ## v1.0.0 (2026-07-27)
 

README.md

@@ -21,10 +21,16 @@ APIs for use with OpenCode, Zed, Cursor, or any compatible client.
 ## Quick Install
 
 ```
-npm install -g ./commandcode-bridge-vX.Y.Z.tgz
+npm install -g ./commandcode-bridge-v1.1.0.tgz
 commandcode-bridge run
 ```
 
+Update when a new release is available:
+
+```
+commandcode-bridge update
+```
+
 Requirements: Node.js 18+, a Command Code account.
 
 ## Documentation

bin/commandcode-bridge.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -21,14 +20,33 @@ if (platform === "win32") {
 const __dirname = dirname(dirname(fileURLToPath(import.meta.url)));
 const binaryPath = join(__dirname, "bin-executables", binaryName);
 
+function getVersion() {
+  try {
+    const pkgPath = join(__dirname, "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+
+const args = process.argv.slice(2);
+
+if (args.includes("--version") || args.includes("-v")) {
+  console.log(`CommandCode Bridge v${getVersion()}`);
+  process.exit(0);
+}
+
 if (!existsSync(binaryPath)) {
   console.error(`Binary not found: ${binaryPath}`);
   console.error("The commandcode-bridge package appears to be corrupted or incomplete.");
   console.error("Try reinstalling from a fresh tarball.");
   process.exit(1);
 }
 
-const child = spawn(binaryPath, process.argv.slice(2), {
+const { spawn } = await import("node:child_process");
+
+const child = spawn(binaryPath, args, {
   stdio: "inherit",
   shell: false,
 });

docs/ARCHITECTURE.md

@@ -22,10 +22,12 @@ commandcode-bridge/
 │       ├── main.dart                  # CLI wiring (TUI / server modes)
 │       ├── models/
 │       │   ├── account.dart           # Account + config store (port persist)
-│       │   └── models_db.dart         # 44 models with plan access metadata
+│       │   ├── models_db.dart         # 44 models with plan access metadata
+│       │   └── version.dart           # Bridge version constant
 │       ├── services/
 │       │   ├── api_client.dart        # HTTP client for api.commandcode.ai
-│       │   └── log_store.dart         # JSONL activity log (2000 entries max)
+│       │   ├── log_store.dart         # JSONL activity log (2000 entries max)
+│       │   └── updater.dart           # Self-update: API cache + download .tgz + npm install -g
 │       ├── server/
 │       │   ├── server_controller.dart  # HTTP server, routing, shared endpoints
 │       │   ├── openai_handler.dart     # OpenAI-compatible proxy

docs/INSTALL.md

@@ -9,6 +9,19 @@ npm install -g ./commandcode-bridge-vX.Y.Z.tgz
 commandcode-bridge run
 ```
 
+## Updating
+
+Once installed, update from the bridge itself:
+
+```bash
+commandcode-bridge update
+```
+
+The update command fetches the latest release tag from GitHub API, downloads the
+`.tgz` asset, removes the previous install, and runs `npm install -g`. The API
+call is cached locally for 1 hour to avoid rate limits. A restart is required
+after updating.
+
 ## Build from Source
 
 ```bash

lib/src/main.dart

@@ -2,20 +2,24 @@ import 'dart:async';
 import 'dart:io';
 import 'package:nocterm/nocterm.dart';
 import 'models/account.dart';
+import 'models/version.dart';
 import 'services/log_store.dart';
+import 'services/updater.dart';
 import 'server/server_controller.dart';
 import 'tui/app.dart';
 
-const _usage = '''CommandCode Bridge
+const _usage = '''CommandCode Bridge  v$bridgeVersion
 
 Usage:
   commandcode-bridge run
   commandcode-bridge run --server
+  commandcode-bridge update
   commandcode-bridge help
 
 Commands:
   run           Start the bridge in TUI mode
   run --server  Start the bridge in headless server mode
+  update        Download and install latest stable release
   help          Show this help screen
 ''';
 
@@ -26,13 +30,20 @@ Future<void> main(List<String> args) async {
   final noArgs = args.isEmpty;
   final showHelp = noArgs || args.contains('help') || args.contains('--help') || args.contains('-h');
   final isRun = !noArgs && args.first == 'run';
+  final isUpdate = !noArgs && args.first == 'update';
+
+  if (args.contains('--version') || args.contains('-v')) {
+    stdout.writeln('CommandCode Bridge v$bridgeVersion');
+    return;
+  }
 
   if (showHelp) {
-    if (noArgs) {
-      _printUsage();
-    } else {
-      _printUsage();
-    }
+    _printUsage();
+    return;
+  }
+
+  if (isUpdate) {
+    await _runUpdate();
     return;
   }
 
@@ -88,6 +99,24 @@ Future<void> main(List<String> args) async {
   server.stop();
 }
 
+Future<void> _runUpdate() async {
+  stdout.writeln('CommandCode Bridge v$bridgeVersion');
+  stdout.writeln('Checking for stable update...');
+  final updater = Updater();
+  try {
+    final result = await updater.update();
+    if (result.success) {
+      stdout.writeln(result.message);
+      stdout.writeln('Restart the bridge to apply.');
+    } else {
+      stderr.writeln('Update failed: ${result.message}');
+      exit(1);
+    }
+  } finally {
+    updater.dispose();
+  }
+}
+
 Future<void> _waitForSignal() async {
   final completer = Completer<void>();
   final sigintSub = ProcessSignal.sigint.watch().listen((_) {

lib/src/models/version.dart

@@ -0,0 +1 @@
+const bridgeVersion = '1.1.0';