openbroker 1.9.1 → 1.9.2

package/CHANGELOG.md

@@ -5,6 +5,7 @@ All notable changes to Open Broker will be documented in this file.
 ## [1.9.1] - 2026-06-22
 
 ### Changed
+- Added `openbroker install --codex` and `npx openbroker@latest install --codex` for one-command Codex skill installation, persistent CLI installation, and restricted API-wallet onboarding.
 - Made restricted API-wallet onboarding the recommended interactive default.
 - Added `openbroker setup --api-wallet` for deterministic agent setup without the wallet-selection prompt.
 - Updated the Codex skill to install the CLI, hand the browser approval URL to the user, wait for authorization, and verify the connected master account without exposing private keys.

package/README.md

@@ -8,6 +8,16 @@ Hyperliquid trading CLI. Execute orders, manage positions, and run trading strat
 npm install -g openbroker
 ```
 
+### Codex: one-command install
+
+Install the Codex skill, persistent CLI, and restricted API-wallet onboarding flow:
+
+```bash
+npx openbroker@latest install --codex
+```
+
+When the command prints an approval URL, open it and connect the funded master Hyperliquid account you want OpenBroker to trade on. Restart Codex or start a new thread when setup finishes, then invoke `$openbroker`.
+
 ## Quick Start
 
 ```bash
@@ -27,6 +37,7 @@ openbroker search --query GOLD              # Find markets
 ### Setup
 
 ```bash
+npx openbroker@latest install --codex  # Codex skill + CLI + API-wallet onboarding
 openbroker setup --api-wallet   # Recommended: restricted agent wallet + browser approval
 openbroker setup                # Interactive; API wallet is the default
 ```

package/SKILL.md

@@ -21,7 +21,15 @@ Use the `openbroker` CLI as the canonical interface. Prefer structured JSON outp
 
 Use the following flow when the user asks to install, set up, or use OpenBroker. Do not ask the user for a private key.
 
-First check whether Node.js 22+ and the CLI are installed:
+For a fresh Codex installation, prefer the unified harness installer:
+
+```bash
+npx --yes openbroker@latest install --codex
+```
+
+This installs or updates the Codex skill, installs the persistent `openbroker` CLI, and starts restricted API-wallet onboarding. Keep the command attached while it prints the browser approval link and polls for authorization.
+
+If the unified installer is unavailable or the skill is already installed, first check whether Node.js 22+ and the CLI are installed:
 
 ```bash
 node --version

package/bin/cli.ts

@@ -11,6 +11,7 @@ const scriptsDir = path.resolve(__dirname, '../scripts');
 
 const commands: Record<string, { script: string; description: string }> = {
   // Setup
+  'install': { script: 'setup/install.ts', description: 'Install OpenBroker for an agent harness' },
   'setup': { script: 'setup/onboard.ts', description: 'Interactive setup wizard' },
   'onboard': { script: 'setup/onboard.ts', description: 'Interactive setup wizard' },
   'approve-builder': { script: 'setup/approve-builder.ts', description: 'Approve builder fee' },
@@ -68,6 +69,7 @@ Open Broker - Hyperliquid Trading CLI
 Usage: openbroker <command> [options]
 
 Setup:
+  install              Install OpenBroker for Codex or another agent harness
   setup                One-command setup (wallet + config + builder approval)
 
 Info Commands:
@@ -136,6 +138,7 @@ Utility:
   approve-builder      Check or retry builder fee approval
 
 Examples:
+  npx openbroker@latest install --codex        # Install skill + CLI + API-wallet setup
   openbroker setup --api-wallet                 # Recommended restricted API-wallet setup
   openbroker account                            # View account info
   openbroker buy --coin ETH --size 0.1          # Market buy 0.1 ETH

package/dist/setup/install.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env npx tsx
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/setup/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../scripts/setup/install.ts"],"names":[],"mappings":""}

package/dist/setup/install.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env npx tsx
+// Harness-aware OpenBroker installer.
+import * as fs from 'fs';
+import * as path from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { spawnSync } from 'child_process';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageRoot = path.resolve(__dirname, '../..');
+const args = new Set(process.argv.slice(2));
+function printUsage() {
+    console.log(`
+OpenBroker Harness Installer
+============================
+
+Usage:
+  openbroker install --codex [options]
+  npx openbroker@latest install --codex [options]
+
+Harnesses:
+  --codex       Install the OpenBroker skill for Codex
+
+Options:
+  --skip-cli    Do not install the persistent global CLI
+  --skip-setup  Install files without starting API-wallet onboarding
+  --help        Show this help
+
+The default Codex flow installs the global CLI, writes the skill under
+$CODEX_HOME/skills/openbroker (default: ~/.codex/skills/openbroker), and starts
+restricted API-wallet onboarding.
+`);
+}
+function fail(message) {
+    console.error(`Error: ${message}`);
+    process.exit(1);
+}
+function assertOpenBrokerSkill(skillPath) {
+    if (!fs.existsSync(skillPath))
+        return;
+    const existing = fs.readFileSync(skillPath, 'utf8');
+    if (!/^name:\s*openbroker\s*$/m.test(existing)) {
+        fail(`refusing to overwrite unrelated skill at ${skillPath}`);
+    }
+}
+function copyManagedFile(source, destination) {
+    if (!fs.existsSync(source)) {
+        fail(`packaged installer asset is missing: ${source}`);
+    }
+    fs.mkdirSync(path.dirname(destination), { recursive: true, mode: 0o755 });
+    fs.copyFileSync(source, destination);
+    fs.chmodSync(destination, 0o644);
+}
+function installCodexSkill() {
+    const codexHome = process.env.CODEX_HOME || path.join(homedir(), '.codex');
+    const destination = path.join(codexHome, 'skills', 'openbroker');
+    const skillPath = path.join(destination, 'SKILL.md');
+    assertOpenBrokerSkill(skillPath);
+    copyManagedFile(path.join(packageRoot, 'SKILL.md'), skillPath);
+    copyManagedFile(path.join(packageRoot, 'agents', 'openai.yaml'), path.join(destination, 'agents', 'openai.yaml'));
+    console.log(`✅ Codex skill installed: ${destination}`);
+    return destination;
+}
+function installGlobalCli() {
+    const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    console.log('\nInstalling the persistent OpenBroker CLI...');
+    const result = spawnSync(npmCommand, ['install', '-g', 'openbroker@latest'], {
+        stdio: 'inherit',
+    });
+    if (result.error) {
+        fail(`could not start npm: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        fail('global CLI installation failed. Fix the npm permission error, then rerun with --skip-cli.');
+    }
+}
+function runApiWalletSetup() {
+    const onboardPath = path.join(packageRoot, 'scripts', 'setup', 'onboard.ts');
+    console.log('\nStarting restricted API-wallet onboarding...\n');
+    const result = spawnSync(process.execPath, ['--import', 'tsx', onboardPath, '--api-wallet'], {
+        stdio: 'inherit',
+        cwd: packageRoot,
+        env: process.env,
+    });
+    if (result.error) {
+        fail(`could not start onboarding: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        fail('API-wallet onboarding did not complete. Rerun `openbroker setup --api-wallet`.');
+    }
+}
+function main() {
+    if (args.has('--help') || args.has('-h')) {
+        printUsage();
+        return;
+    }
+    if (!args.has('--codex')) {
+        printUsage();
+        fail('choose a supported harness flag such as --codex');
+    }
+    console.log('OpenBroker — Codex Installation');
+    console.log('================================\n');
+    installCodexSkill();
+    if (!args.has('--skip-cli')) {
+        installGlobalCli();
+    }
+    if (!args.has('--skip-setup')) {
+        runApiWalletSetup();
+    }
+    console.log('\n✅ OpenBroker installation complete.');
+    console.log('Restart Codex or start a new thread, then invoke $openbroker.');
+}
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbroker",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "description": "Hyperliquid trading CLI - execute orders, manage positions, and run trading strategies",
   "type": "module",
   "bin": {

package/scripts/setup/install.ts

@@ -0,0 +1,146 @@
+#!/usr/bin/env npx tsx
+// Harness-aware OpenBroker installer.
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { spawnSync } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageRoot = path.resolve(__dirname, '../..');
+const args = new Set(process.argv.slice(2));
+
+function printUsage(): void {
+  console.log(`
+OpenBroker Harness Installer
+============================
+
+Usage:
+  openbroker install --codex [options]
+  npx openbroker@latest install --codex [options]
+
+Harnesses:
+  --codex       Install the OpenBroker skill for Codex
+
+Options:
+  --skip-cli    Do not install the persistent global CLI
+  --skip-setup  Install files without starting API-wallet onboarding
+  --help        Show this help
+
+The default Codex flow installs the global CLI, writes the skill under
+$CODEX_HOME/skills/openbroker (default: ~/.codex/skills/openbroker), and starts
+restricted API-wallet onboarding.
+`);
+}
+
+function fail(message: string): never {
+  console.error(`Error: ${message}`);
+  process.exit(1);
+}
+
+function assertOpenBrokerSkill(skillPath: string): void {
+  if (!fs.existsSync(skillPath)) return;
+
+  const existing = fs.readFileSync(skillPath, 'utf8');
+  if (!/^name:\s*openbroker\s*$/m.test(existing)) {
+    fail(`refusing to overwrite unrelated skill at ${skillPath}`);
+  }
+}
+
+function copyManagedFile(source: string, destination: string): void {
+  if (!fs.existsSync(source)) {
+    fail(`packaged installer asset is missing: ${source}`);
+  }
+
+  fs.mkdirSync(path.dirname(destination), { recursive: true, mode: 0o755 });
+  fs.copyFileSync(source, destination);
+  fs.chmodSync(destination, 0o644);
+}
+
+function installCodexSkill(): string {
+  const codexHome = process.env.CODEX_HOME || path.join(homedir(), '.codex');
+  const destination = path.join(codexHome, 'skills', 'openbroker');
+  const skillPath = path.join(destination, 'SKILL.md');
+
+  assertOpenBrokerSkill(skillPath);
+  copyManagedFile(path.join(packageRoot, 'SKILL.md'), skillPath);
+  copyManagedFile(
+    path.join(packageRoot, 'agents', 'openai.yaml'),
+    path.join(destination, 'agents', 'openai.yaml'),
+  );
+
+  console.log(`✅ Codex skill installed: ${destination}`);
+  return destination;
+}
+
+function installGlobalCli(): void {
+  const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+
+  console.log('\nInstalling the persistent OpenBroker CLI...');
+  const result = spawnSync(npmCommand, ['install', '-g', 'openbroker@latest'], {
+    stdio: 'inherit',
+  });
+
+  if (result.error) {
+    fail(`could not start npm: ${result.error.message}`);
+  }
+  if (result.status !== 0) {
+    fail(
+      'global CLI installation failed. Fix the npm permission error, then rerun with --skip-cli.',
+    );
+  }
+}
+
+function runApiWalletSetup(): void {
+  const onboardPath = path.join(packageRoot, 'scripts', 'setup', 'onboard.ts');
+
+  console.log('\nStarting restricted API-wallet onboarding...\n');
+  const result = spawnSync(
+    process.execPath,
+    ['--import', 'tsx', onboardPath, '--api-wallet'],
+    {
+      stdio: 'inherit',
+      cwd: packageRoot,
+      env: process.env,
+    },
+  );
+
+  if (result.error) {
+    fail(`could not start onboarding: ${result.error.message}`);
+  }
+  if (result.status !== 0) {
+    fail('API-wallet onboarding did not complete. Rerun `openbroker setup --api-wallet`.');
+  }
+}
+
+function main(): void {
+  if (args.has('--help') || args.has('-h')) {
+    printUsage();
+    return;
+  }
+
+  if (!args.has('--codex')) {
+    printUsage();
+    fail('choose a supported harness flag such as --codex');
+  }
+
+  console.log('OpenBroker — Codex Installation');
+  console.log('================================\n');
+
+  installCodexSkill();
+
+  if (!args.has('--skip-cli')) {
+    installGlobalCli();
+  }
+
+  if (!args.has('--skip-setup')) {
+    runApiWalletSetup();
+  }
+
+  console.log('\n✅ OpenBroker installation complete.');
+  console.log('Restart Codex or start a new thread, then invoke $openbroker.');
+}
+
+main();