fix: Ctrl+C notification only, auto-port, help version

Fix: Ctrl+C
- Ctrl+C shows red bold status notification (never quit panel)
- Quit only via [q] key

Fix: auto-increment port
- If configured port is in use, bridge tries port+1..+100
- Port switch logged to log sidebar
- TUI header shows actual running port (currentPort)

Fix: help text
- -v / --version flag listed in help screen

Fix: port references
- AppConfig.defaultPort constant replaces all hardcoded 17077
- Port config panel placeholder/hint/reset use dynamic default

See CHANGELOG.md for full details.

Author: Khip01

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project will be documented in this file.
 
+## v1.1.1 (2026-07-29)
+
+### Fixes
+
+- Ctrl+C: status bar notification only (no quit panel). Use [q] to quit.
+- Auto-increment port: if configured port is in use, bridge tries port+1, +2, ... up to 100 attempts, logs the switch
+- Help screen now includes `-v` / `--version` flag
+
 ## v1.1.0 (2026-07-28)
 
 ### Features

README.md

@@ -21,7 +21,7 @@ APIs for use with OpenCode, Zed, Cursor, or any compatible client.
 ## Quick Install
 
 ```
-npm install -g ./commandcode-bridge-v1.1.0.tgz
+npm install -g ./commandcode-bridge-v1.1.1.tgz
 commandcode-bridge run
 ```
 

docs/TUI.md

@@ -22,6 +22,7 @@
 | `p` | Always | Configure proxy port (with availability scan) |
 | `h` | Always | Open help |
 | `q` | Always | Quit (with confirmation) |
+| `Ctrl+C` | Always | Status bar hint (use [q] to quit) |
 | `up/down` | Main | Scroll content / navigate models |
 | `PgUp/PgDn` | Main | Scroll 10 lines |
 | `Enter` | Models page | Copy selected model codename to clipboard |
@@ -47,6 +48,10 @@ Press `[p]` to open port config panel:
 - Config saved to `~/.config/commandcode-bridge/config.json`
 - Restart required for change to take effect
 
+If the configured port is in use at startup, the bridge auto-increments
+(port+1, port+2, ...) up to 100 attempts until it finds a free port.
+The switch is logged and the running port is shown in the header.
+
 ## Plan Access
 
 Models in page 5 are prioritized by your plan:

lib/src/main.dart

@@ -21,6 +21,7 @@ Commands:
   run --server  Start the bridge in headless server mode
   update        Download and install latest stable release
   help          Show this help screen
+  -v, --version Print version string
 ''';
 
 void _printUsage() => stdout.write(_usage);

lib/src/models/account.dart

@@ -76,21 +76,23 @@ class AccountStore {
 }
 
 class AppConfig {
+  static const defaultPort = 17077;
+
   int serverPort;
   String apiBaseUrl;
   String cliVersion;
 
   // Port 17077 chosen to avoid neighbors with cobuddy-bridge (20130)
   // and common service ports
   AppConfig({
-    this.serverPort = 17077,
+    this.serverPort = defaultPort,
     this.apiBaseUrl = 'https://api.commandcode.ai',
     this.cliVersion = '1.4.1',
   });
 
   factory AppConfig.fromJson(Map<String, dynamic> json) {
     return AppConfig(
-      serverPort: json['server_port'] as int? ?? 17077,
+      serverPort: json['server_port'] as int? ?? defaultPort,
       apiBaseUrl: json['api_base_url'] as String? ?? 'https://api.commandcode.ai',
       cliVersion: json['cli_version'] as String? ?? '1.4.1',
     );

lib/src/models/version.dart

@@ -1 +1 @@
-const bridgeVersion = '1.1.0';
+const bridgeVersion = '1.1.1';

lib/src/server/server_controller.dart

@@ -18,23 +18,39 @@ class ServerController {
   bool get isRunning => _running;
   String get currentModel => _currentModel;
   int get modelVersion => _modelVersion;
+  int get currentPort => _runningPort;
 
   ServerController({required this.accountStore, required this.configStore});
 
+  int _runningPort = 0;
+
   Future<void> start() async {
     if (_running) return;
-    try {
-      _server = await HttpServer.bind(
-        InternetAddress.loopbackIPv4,
-        configStore.config.serverPort,
-      );
-      _running = true;
-      LogStore.success('Bridge started on port ${configStore.config.serverPort}');
-      _server!.listen(_handleRequest);
-    } catch (e) {
-      LogStore.error('Failed to start server: $e');
-      rethrow;
+
+    var port = configStore.config.serverPort;
+    const maxAttempts = 100;
+
+    for (var i = 0; i < maxAttempts; i++) {
+      try {
+        _server = await HttpServer.bind(
+          InternetAddress.loopbackIPv4,
+          port,
+        );
+        if (port != configStore.config.serverPort) {
+          LogStore.warning('Port ${configStore.config.serverPort} in use, auto-incremented to $port');
+        }
+        _runningPort = port;
+        _running = true;
+        LogStore.success('Bridge started on port $port');
+        _server!.listen(_handleRequest);
+        return;
+      } catch (e) {
+        LogStore.warning('Port $port in use, trying ${port + 1}...');
+        port++;
+      }
     }
+
+    throw Exception('No available port found after $maxAttempts attempts');
   }
 
   void stop() {

lib/src/tui/app.dart

@@ -154,6 +154,7 @@ class AppState extends State<CmdBridgeApp> {
     final msg = _status;
     if (msg.startsWith('Data refreshed') || msg.contains('Copied')) return Colors.green;
     if (msg.startsWith('Fetching') || msg.startsWith('Opening') || msg.startsWith('Copying')) return Colors.cyan;
+    if (msg.startsWith('Use [q] to quit')) return Colors.red;
     if (msg.startsWith('No API') || msg.startsWith('Refresh failed') || msg.contains('failed') || msg.contains('Invalid') || msg.contains('in use') || msg.contains('Cannot')) return Colors.red;
     if (msg.contains('Clear') || msg.contains('Warning') || msg.contains('Restart') || msg.contains('Already') || msg.contains('confirm') || msg.startsWith('No entries')) return Colors.yellow;
     return Colors.cyan;
@@ -249,9 +250,7 @@ class AppState extends State<CmdBridgeApp> {
 
     if (_panel == _Panel.main) {
       if (e.logicalKey == LogicalKey.keyC && e.isControlPressed) {
-        _panel = _Panel.quit;
-        _setStatus('Press q or Ctrl+C to quit', duration: 10);
-        setState(() {});
+        _setStatus('Use [q] to quit', duration: 3);
         return true;
       }
 
@@ -614,9 +613,9 @@ class AppState extends State<CmdBridgeApp> {
   void _doSetPort() {
     final raw = _portCtrl.text.trim();
     if (raw.isEmpty) {
-      _config.config.serverPort = 17077;
+      _config.config.serverPort = AppConfig.defaultPort;
       _config.save();
-      _setStatus('Port reset to default 17077. Restart required.', duration: 5);
+      _setStatus('Port reset to default ${AppConfig.defaultPort}. Restart required.', duration: 5);
       _panel = _Panel.main;
       setState(() {});
       return;
@@ -658,7 +657,7 @@ class AppState extends State<CmdBridgeApp> {
     final email = whoami?.email ?? '';
     final planName = sub != null ? _planDisplayName(sub.planId) : '';
     final isRunning = _proxy.isRunning;
-    final port = _config.config.serverPort;
+    final port = _proxy.isRunning ? _proxy.currentPort : _config.config.serverPort;
 
     return Container(
       padding: const EdgeInsets.all(1),
@@ -1474,7 +1473,7 @@ class AppState extends State<CmdBridgeApp> {
                   child: TextField(
                     controller: _portCtrl,
                     focused: true,
-                    placeholder: '17077',
+                    placeholder: '${AppConfig.defaultPort}',
                     onSubmitted: (_) => _doSetPort(),
                   ),
                 ),
@@ -1500,7 +1499,7 @@ class AppState extends State<CmdBridgeApp> {
               const Text('No recommended ports available',
                   style: TextStyle(color: Colors.red)),
             const SizedBox(height: 1),
-            const Text('Empty = reset to default (17077).',
+            Text('Empty = reset to default (${AppConfig.defaultPort}).',
                 style: TextStyle(color: Colors.grey)),
             const SizedBox(height: 1),
             const Text('Restart required for port change.',
@@ -1529,7 +1528,10 @@ class AppState extends State<CmdBridgeApp> {
       ),
       child: Row(
         children: [
-          Text(_status, style: TextStyle(color: _notifColor())),
+          Text(_status, style: TextStyle(
+            color: _notifColor(),
+            fontWeight: _status.startsWith('Use [q] to quit') ? FontWeight.bold : null,
+          )),
         ],
       ),
     );

package.json

@@ -1,6 +1,6 @@
 {
   "name": "commandcode-bridge",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Command Code single-account proxy bridge with TUI dashboard. OpenAI-compatible endpoint for OpenCode, Cursor, etc.",
   "type": "module",
   "bin": {

pubspec.yaml

@@ -1,6 +1,6 @@
 name: commandcode_bridge
 description: Command Code single-account proxy bridge with OpenAI-compatible endpoint
-version: 1.1.0
+version: 1.1.1
 
 environment:
   sdk: ^3.10.8