@loucompanion/forge-bridge 0.1.1-dev.54464ef723de → 0.1.1-dev.5b0a0fe4307c

package/dist/cli/cli.service.js

@@ -544,35 +544,51 @@ function normalizePairingCode(code) {
 function normalizeServerUrl(serverUrl) {
     return serverUrl.endsWith("/") ? serverUrl : `${serverUrl}/`;
 }
+function isHelpArg(arg) {
+    return arg === "help" || arg === "--help" || arg === "-h";
+}
 function usage() {
     return helpText();
 }
 function helpText() {
     const version = defaultBridgeServiceConfig().version ?? forgeBridgeVersion;
     return [
-        `🛠 Forge Bridge ${version} — Local provider runners for Forge.`,
+        `Forge Bridge ${version}`,
+        "Local runner bridge for Forge agents.",
+        "",
+        "Forge Bridge lets this machine run provider CLIs like Codex or Cursor for Forge.",
+        "Keep `forge-bridge connect` open while Forge dispatches work.",
         "",
-        "Usage: forge-bridge [options] [command]",
+        "Usage:",
+        "  forge-bridge <command> [options]",
+        "  forge-bridge help <command>",
         "",
         "Options:",
-        "  -h, --help       Display help for command",
-        "  -v, --version    Output the version number",
+        "  -h, --help       Show help.",
+        "  -v, --version    Print the bridge version.",
+        "",
+        "Setup commands:",
+        "  pair [code]       Pair this machine with Forge and save runner credentials.",
+        "  connect           Start the bridge and wait for Forge dispatches.",
+        "  status            Show config, runner identity, repos, provider CLIs, and updates.",
         "",
-        "Commands:",
-        "  Hint: commands suffixed with * have detailed help. Run <command> --help for details.",
-        "  connect *        Start the runner bridge and wait for Forge dispatches",
-        "  pair *           Pair this machine with Forge and save runner credentials",
-        "  status *         Show config, runner identity, repos, provider CLIs, and updates",
-        "  add-repo *       Map a Forge repo label/name to a local checkout path",
-        "  remove-repo *    Remove a saved repo mapping",
-        "  cleanup *        Prune managed bridge worktrees",
-        "  version *        Print the installed bridge package version",
-        "  help *           Display help for command",
-        "  run-once *       Internal: run one dispatch packet from JSON",
-        "  mcp *            Internal: run the phase-completion MCP server",
+        "Repo commands:",
+        "  add-repo          Map a Forge repo label/name to a local checkout path.",
+        "  remove-repo       Remove a saved repo mapping.",
+        "  cleanup           Prune managed bridge worktrees.",
+        "",
+        "Internal commands:",
+        "  run-once          Run one dispatch packet. Used by Forge and tests.",
+        "  mcp               Run the phase-completion MCP server for provider CLIs.",
+        "",
+        "Common flow:",
+        "  1. Install or update: npm install -g @loucompanion/forge-bridge@next",
+        "  2. In Forge: Profile Settings -> Runners -> Pair runner.",
+        "  3. Run the pairing command Forge shows you.",
+        "  4. Start the bridge: forge-bridge connect",
         "",
         "Examples:",
-        "  npm install -g @loucompanion/forge-bridge@next",
+        "  forge-bridge version",
         "  forge-bridge pair 1234-5678 --server https://srv1493013.tail66073d.ts.net:8443 --repo-root \"%USERPROFILE%\\ForgeRepos\"",
         "  forge-bridge connect",
         "  forge-bridge status --check-updates",
@@ -580,9 +596,13 @@ function helpText() {
         "  forge-bridge cleanup --stale",
         "",
         "Troubleshooting:",
-        "  If Forge says the bridge is old: npm install -g @loucompanion/forge-bridge@next",
-        "  If connect shows 502/500: leave it open; it reconnects with backoff while dev restarts.",
-        "  If a provider is missing: run forge-bridge status --check-updates and verify CLI login.",
+        "  - If Forge says the bridge is old, run npm install -g @loucompanion/forge-bridge@next.",
+        "  - If connect shows 502/500, leave it open; it reconnects with backoff while dev restarts.",
+        "  - If a provider is missing, run forge-bridge status --check-updates and verify the CLI login.",
+        "",
+        "Command help:",
+        "  forge-bridge help pair",
+        "  forge-bridge connect --help",
         "",
         "Docs:",
         "  https://github.com/coleman399/Forge/tree/develop/tools/forge-bridge#readme",

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const forgeBridgeVersion = "0.1.1-dev.54464ef723de";
+export declare const forgeBridgeVersion = "0.1.1-dev.5b0a0fe4307c";

package/dist/version.js

@@ -1 +1 @@
-export const forgeBridgeVersion = "0.1.1-dev.54464ef723de";
+export const forgeBridgeVersion = "0.1.1-dev.5b0a0fe4307c";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loucompanion/forge-bridge",
-  "version": "0.1.1-dev.54464ef723de",
+  "version": "0.1.1-dev.5b0a0fe4307c",
   "description": "Forge runner bridge CLI for connecting local developer machines to Forge dispatch.",
   "license": "UNLICENSED",
   "type": "module",