@tumnel/codex 0.1.1 → 0.1.3

package/README.md

@@ -5,10 +5,18 @@ Standalone connector that bridges the Codex CLI agent to Tumnel web clients. It
 through the Tumnel bridge protocol, and lets Tumnel web clients build and control Codex threads
 with the same experience as the OpenCode connector: sessions, streaming turns, tools, and pairing.
 
-## Run the connector
+## Install and run the connector
+
+The standard setup command prepares the host identity and starts the connector:
+
+```sh
+npx @tumnel/codex@0.1.3 install
+```
+
+`connect` remains available as an explicit alias:
 
 ```sh
-npx @tumnel/codex connect
+npx @tumnel/codex@0.1.3 connect
 ```
 
 The connector starts the Codex agent bridge and keeps it connected to the Tumnel relay until

package/dist/cli.js

@@ -1504,7 +1504,7 @@ var TumnelBridgeClient = class {
           version: BRIDGE_PROTOCOL_VERSION,
           type: "device.hello",
           clientId: this.identity.deviceId,
-          agentVersion: "0.1.1",
+          agentVersion: "0.1.3",
           connectorId: "codex"
         };
         socket.send(encodeBridgeMessage(hello));
@@ -1812,11 +1812,23 @@ async function createCodexConnector(options = {}) {
 }
 
 // src/cli.ts
+var waitForTumnelConnector = async (bridge, timeoutMs = 15e3) => {
+  const deadline = Date.now() + timeoutMs;
+  while (bridge.state !== "connected" && Date.now() < deadline) {
+    await new Promise((resolve) => setTimeout(resolve, 100));
+  }
+  return bridge.state === "connected";
+};
 var printHelp = () => {
   console.log(`Tumnel connector for Codex
 
 Usage:
-  tumnel-codex [options]
+  tumnel-codex install [options]
+  tumnel-codex connect [options]
+
+The install command is the standard one-command setup for Codex. It prepares the
+Tumnel identity and starts the connector. The connect command remains available
+as an explicit alias.
 
 Options:
   --model <model>              Codex model id (e.g. gpt-5-mini)
@@ -1845,7 +1857,7 @@ var printVersion = async () => {
   console.log(`@tumnel/codex ${version}`);
 };
 var run = async () => {
-  const command = process.argv[2] ?? "connect";
+  const command = process.argv[2] ?? "install";
   if (command === "--help" || command === "-h" || command === "help") {
     printHelp();
     return;
@@ -1854,10 +1866,10 @@ var run = async () => {
     printVersion();
     return;
   }
-  if (command !== "connect" && !command.startsWith("-")) {
+  if (command !== "install" && command !== "connect" && !command.startsWith("-")) {
     throw new Error(`Unknown command: ${command}`);
   }
-  const args = command === "connect" ? process.argv.slice(3) : process.argv.slice(2);
+  const args = command === "install" || command === "connect" ? process.argv.slice(3) : process.argv.slice(2);
   if (args.includes("--help") || args.includes("-h")) {
     printHelp();
     return;
@@ -1887,11 +1899,23 @@ var run = async () => {
   flag("--relay-url");
   flag("--sandbox");
   flag("--approval-policy");
+  const packageJson = JSON.parse(
+    await import("fs/promises").then(
+      ({ readFile: readFile3 }) => readFile3(new URL("../package.json", import.meta.url), "utf8")
+    )
+  );
+  if (command === "install") console.log(`Installed @tumnel/codex@${packageJson.version}`);
   const connector = await createCodexConnector({ config });
   const port = connector.pairingServer?.port;
-  console.log("Tumnel Codex connector started");
+  console.log("Starting Tumnel Codex connector...");
   console.log(`  Device ID:    ${connector.bridge.deviceId}`);
   if (port) console.log(`  Pairing port: http://127.0.0.1:${port}`);
+  console.log("Waiting for the Tumnel connector...");
+  if (await waitForTumnelConnector(connector.bridge)) {
+    console.log("Tumnel connected.");
+  } else {
+    console.log("Tumnel connector started; waiting for the relay in background.");
+  }
   console.log("Press Ctrl+C to stop.\n");
   let stopping = false;
   const stop = async () => {