@oblivihon/steer 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,94 @@
+# @oblivihon/steer
+
+CLI worker for **Steer** — runs local Cursor agents on your machine for multiplayer sessions hosted in the web app.
+
+When you create a **Local** session in Steer, prompts are relayed to this worker, which executes `cursor agent` against a folder on your machine.
+
+## Requirements
+
+- Node.js 18+
+- [Cursor CLI](https://cursor.com) on your `PATH` (`cursor` command)
+- A Steer account (sign in on the web app)
+
+## Install
+
+```bash
+npm install -g @oblivihon/steer
+```
+
+Or from this repo:
+
+```bash
+cd cli
+pnpm install
+pnpm build
+npm link
+```
+
+## Quick start
+
+1. Sign in on the Steer web app and open **Pair CLI** (`/cli-pair`).
+2. Generate a pairing code.
+3. On your machine:
+
+```bash
+steer login
+# Server URL defaults to https://cursor-multiplayer-agent.onrender.com — press Enter
+# Paste the pairing code
+
+cursor agent login   # if not already logged into Cursor CLI
+steer start
+```
+
+4. Keep `steer start` running while you use Local sessions in the browser.
+
+Credentials are stored at `~/.config/steer/config.json`.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `steer login` | Pair with your Steer account via a one-time web code |
+| `steer logout` | Clear stored credentials |
+| `steer status` | Show logged-in user, server URL, and your rooms |
+| `steer start` | Start the worker (connects to the API over WebSocket) |
+| `steer start --repo <path>` | Same, but force every prompt to use this repo path |
+
+## Server URL
+
+`steer login` defaults to:
+
+```
+https://cursor-multiplayer-agent.onrender.com
+```
+
+Override per login at the prompt, or with:
+
+```bash
+export STEER_SERVER_URL=http://localhost:3000
+steer login
+```
+
+Use the local URL when developing against a local API.
+
+## What the worker does
+
+While `steer start` is connected, the API can ask your machine to:
+
+- List Cursor models (`cursor agent --list-models`)
+- Open a native folder picker for Local session create
+- Run agent prompts in the selected repo and stream events back to the room
+
+## Development
+
+```bash
+pnpm install
+pnpm dev          # run via tsx without building
+pnpm build        # compile to dist/
+```
+
+The published binary is `dist/index.js` (`bin`: `steer`).
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -1,4 +1,5 @@
 import { type Config } from "./config.js";
-export declare function login(serverUrl: string, email: string, password: string): Promise<Config>;
+/** Pair CLI with a Clerk-authenticated web account via one-time code. */
+export declare function loginWithPairingCode(serverUrl: string, code: string): Promise<Config>;
 export declare function logout(): void;
 export declare function getAuthHeaders(): Record<string, string>;

package/dist/auth.js

@@ -1,23 +1,22 @@
-import { loadConfig, saveConfig, clearConfig } from "./config.js";
-export async function login(serverUrl, email, password) {
-    const url = `${serverUrl.replace(/\/+$/, "")}/api/auth/login`;
-    const res = await fetch(url, {
+import { saveConfig, clearConfig, loadConfig } from "./config.js";
+/** Pair CLI with a Clerk-authenticated web account via one-time code. */
+export async function loginWithPairingCode(serverUrl, code) {
+    const base = serverUrl.replace(/\/+$/, "");
+    const normalized = code.trim().toUpperCase().replace(/\s+/g, "");
+    const res = await fetch(`${base}/api/auth/pairing/claim`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ email, password }),
+        body: JSON.stringify({ code: normalized }),
     });
     if (!res.ok) {
-        const body = await res.text();
-        throw new Error(`Login failed (${res.status}): ${body}`);
+        const err = (await res.json().catch(() => ({})));
+        throw new Error(err.error || `Pairing failed (${res.status})`);
     }
     const data = (await res.json());
-    if (!data.token) {
-        throw new Error("Server did not return a token");
-    }
     const config = {
-        serverUrl: serverUrl.replace(/\/+$/, ""),
+        serverUrl: base,
         token: data.token,
-        email,
+        email: data.user.email,
     };
     saveConfig(config);
     return config;

package/dist/config.d.ts

@@ -3,6 +3,8 @@ export interface Config {
     token: string;
     email: string;
 }
+/** Production API (override with STEER_SERVER_URL for local/dev). */
+export declare const DEFAULT_SERVER_URL: string;
 export declare function getConfigDir(): string;
 export declare function loadConfig(): Config | null;
 export declare function saveConfig(config: Config): void;

package/dist/config.js

@@ -1,6 +1,9 @@
 import { mkdirSync, readFileSync, writeFileSync, rmSync, existsSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
+/** Production API (override with STEER_SERVER_URL for local/dev). */
+export const DEFAULT_SERVER_URL = (process.env.STEER_SERVER_URL ||
+    "https://cursor-multiplayer-agent.onrender.com").replace(/\/+$/, "");
 const CONFIG_DIR_NAME = "steer";
 const LEGACY_CONFIG_DIR_NAME = "shared-agent";
 const CONFIG_FILE = "config.json";

package/dist/index.js

@@ -3,8 +3,8 @@ import { Command } from "commander";
 import chalk from "chalk";
 import ora from "ora";
 import { createInterface } from "readline";
-import { login, logout } from "./auth.js";
-import { loadConfig } from "./config.js";
+import { loginWithPairingCode, logout } from "./auth.js";
+import { DEFAULT_SERVER_URL, loadConfig } from "./config.js";
 import { ensureCursorAuth } from "./cursorAuth.js";
 import { startWorker } from "./worker.js";
 const program = new Command();
@@ -17,57 +17,27 @@ function prompt(question) {
         });
     });
 }
-function promptSecret(question) {
-    return new Promise((resolve) => {
-        process.stdout.write(question);
-        const stdin = process.stdin;
-        const wasRaw = stdin.isRaw;
-        if (stdin.isTTY)
-            stdin.setRawMode(true);
-        let input = "";
-        const onData = (ch) => {
-            const c = ch.toString();
-            if (c === "\n" || c === "\r") {
-                stdin.removeListener("data", onData);
-                if (stdin.isTTY)
-                    stdin.setRawMode(wasRaw ?? false);
-                process.stdout.write("\n");
-                resolve(input);
-            }
-            else if (c === "\u0003") {
-                process.exit(1);
-            }
-            else if (c === "\u007F" || c === "\b") {
-                input = input.slice(0, -1);
-            }
-            else {
-                input += c;
-            }
-        };
-        stdin.resume();
-        stdin.on("data", onData);
-    });
-}
 program
     .name("steer")
     .description("CLI worker for Steer — run local Cursor agents")
-    .version("0.1.0");
+    .version("0.1.1");
 program
     .command("login")
-    .description("Log in to the Steer server")
+    .description("Pair CLI with your Steer account (Clerk via web pairing code)")
     .action(async () => {
     try {
-        const serverUrl = await prompt("Server URL: ");
-        const email = await prompt("Email: ");
-        const password = await promptSecret("Password: ");
-        if (!serverUrl || !email || !password) {
-            console.error(chalk.red("All fields are required."));
+        console.log(chalk.gray("\n  1. Sign in on the web app\n  2. Open /cli-pair and generate a code\n  3. Enter that code below\n"));
+        const serverUrlRaw = await prompt(`Server URL [${DEFAULT_SERVER_URL}]: `);
+        const serverUrl = serverUrlRaw || DEFAULT_SERVER_URL;
+        const code = await prompt("Pairing code: ");
+        if (!code) {
+            console.error(chalk.red("Pairing code is required."));
             process.exit(1);
         }
-        const spinner = ora("Logging in…").start();
+        const spinner = ora("Pairing…").start();
         try {
-            const config = await login(serverUrl, email, password);
-            spinner.succeed(`Logged in as ${chalk.cyan(config.email)}`);
+            const config = await loginWithPairingCode(serverUrl, code);
+            spinner.succeed(`Paired as ${chalk.cyan(config.email)}`);
         }
         catch (err) {
             spinner.fail(err.message);

package/dist/listModels.d.ts

@@ -0,0 +1,6 @@
+export interface ModelInfo {
+    id: string;
+    displayName: string;
+}
+/** Models available to the logged-in Cursor CLI on this machine. */
+export declare function listLocalModels(): Promise<ModelInfo[]>;

package/dist/listModels.js

@@ -0,0 +1,62 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+const execFileAsync = promisify(execFile);
+const ANSI_RE = /\x1b\[[0-9;]*[a-zA-Z]/g;
+const MODEL_LINE_RE = /^([a-zA-Z0-9][a-zA-Z0-9._-]*)\s+[-–—]\s+(.+)$/;
+function stripAnsi(text) {
+    return text.replace(ANSI_RE, "").replace(/\r/g, "");
+}
+function parseModels(stdout) {
+    const models = [];
+    const seen = new Set();
+    for (const raw of stripAnsi(stdout).split("\n")) {
+        const line = raw.trim();
+        if (!line || /^available models$/i.test(line))
+            continue;
+        const m = line.match(MODEL_LINE_RE);
+        if (!m)
+            continue;
+        const id = m[1];
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        models.push({ id, displayName: m[2].trim() });
+    }
+    return models;
+}
+async function runListModels() {
+    try {
+        const { stdout } = await execFileAsync("cursor", ["agent", "--list-models"], {
+            timeout: 60_000,
+            encoding: "utf8",
+            maxBuffer: 16 * 1024 * 1024,
+            env: {
+                ...process.env,
+                NO_COLOR: "1",
+                FORCE_COLOR: "0",
+                TERM: "dumb",
+            },
+        });
+        return stdout || "";
+    }
+    catch (err) {
+        const e = err;
+        if (e.stdout && String(e.stdout).trim())
+            return String(e.stdout);
+        if (e.code === "ENOENT") {
+            throw new Error("cursor CLI not found. Install Cursor and ensure `cursor` is on PATH.");
+        }
+        throw new Error(e.stderr?.trim() ||
+            e.message ||
+            "Failed to run `cursor agent --list-models`");
+    }
+}
+/** Models available to the logged-in Cursor CLI on this machine. */
+export async function listLocalModels() {
+    const stdout = await runListModels();
+    const models = parseModels(stdout);
+    if (models.length === 0) {
+        return [{ id: "auto", displayName: "Auto" }];
+    }
+    return models;
+}

package/dist/pickFolder.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Open a native OS folder picker and return an absolute path.
+ * Returns null if the user cancels.
+ */
+export declare function pickFolder(): Promise<string | null>;

package/dist/pickFolder.js

@@ -0,0 +1,65 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { platform } from "os";
+const execFileAsync = promisify(execFile);
+/**
+ * Open a native OS folder picker and return an absolute path.
+ * Returns null if the user cancels.
+ */
+export async function pickFolder() {
+    const os = platform();
+    try {
+        if (os === "darwin") {
+            const { stdout } = await execFileAsync("osascript", [
+                "-e",
+                'POSIX path of (choose folder with prompt "Select a repository folder")',
+            ]);
+            const path = stdout.trim().replace(/\/$/, "");
+            return path || null;
+        }
+        if (os === "win32") {
+            const script = [
+                "Add-Type -AssemblyName System.Windows.Forms",
+                "$d = New-Object System.Windows.Forms.FolderBrowserDialog",
+                '$d.Description = "Select a repository folder"',
+                "$d.ShowNewFolderButton = $true",
+                "if ($d.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) { Write-Output $d.SelectedPath }",
+            ].join("; ");
+            const { stdout } = await execFileAsync("powershell", [
+                "-NoProfile",
+                "-Command",
+                script,
+            ]);
+            const path = stdout.trim();
+            return path || null;
+        }
+        // Linux: prefer zenity, then kdialog
+        try {
+            const { stdout } = await execFileAsync("zenity", [
+                "--file-selection",
+                "--directory",
+                "--title=Select a repository folder",
+            ]);
+            const path = stdout.trim();
+            return path || null;
+        }
+        catch {
+            const { stdout } = await execFileAsync("kdialog", [
+                "--getexistingdirectory",
+                process.env.HOME || "/",
+                "--title",
+                "Select a repository folder",
+            ]);
+            const path = stdout.trim();
+            return path || null;
+        }
+    }
+    catch (err) {
+        const e = err;
+        // User cancel: osascript exit 1 / zenity exit 1
+        if (e.code === 1 || e.code === "1")
+            return null;
+        throw new Error(e.message ||
+            "Failed to open folder picker. On Linux install zenity or kdialog.");
+    }
+}

package/dist/worker.js

@@ -3,6 +3,8 @@ import { hostname } from "os";
 import { createHash } from "crypto";
 import chalk from "chalk";
 import { loadConfig } from "./config.js";
+import { pickFolder } from "./pickFolder.js";
+import { listLocalModels } from "./listModels.js";
 import { runAgent, abortAgent, isEditTool, getFileDiff, } from "./agent.js";
 function generateWorkerId(email) {
     const raw = `${hostname()}-${email}`;
@@ -28,7 +30,10 @@ export function startWorker(repoPathOverride) {
     });
     socket.on("connect", () => {
         console.log(chalk.green("✓ Connected to server"));
-        socket.emit("worker:ready", { workerId });
+        socket.emit("worker:ready", {
+            workerId,
+            machineName: hostname(),
+        });
     });
     socket.on("disconnect", (reason) => {
         console.log(chalk.yellow(`Disconnected: ${reason}`));
@@ -99,6 +104,50 @@ export function startWorker(repoPathOverride) {
         console.log(chalk.yellow("  ⚠ Abort requested"));
         abortAgent();
     });
+    socket.on("worker:pick-folder", async (payload) => {
+        console.log(chalk.cyan("  📂 Opening folder picker…"));
+        try {
+            const path = await pickFolder();
+            if (path) {
+                console.log(chalk.green(`  ✓ Selected: ${path}`));
+            }
+            else {
+                console.log(chalk.yellow("  Folder pick cancelled"));
+            }
+            socket.emit("worker:folder-picked", {
+                requestId: payload.requestId,
+                path,
+            });
+        }
+        catch (err) {
+            const message = err.message;
+            console.error(chalk.red(`  ✗ Folder picker error: ${message}`));
+            socket.emit("worker:folder-picked", {
+                requestId: payload.requestId,
+                path: null,
+                error: message,
+            });
+        }
+    });
+    socket.on("worker:list-models", async (payload) => {
+        console.log(chalk.cyan("  Listing Cursor models…"));
+        try {
+            const models = await listLocalModels();
+            console.log(chalk.green(`  ✓ ${models.length} models`));
+            socket.emit("worker:models-listed", {
+                requestId: payload.requestId,
+                models,
+            });
+        }
+        catch (err) {
+            const message = err.message;
+            console.error(chalk.red(`  ✗ List models error: ${message}`));
+            socket.emit("worker:models-listed", {
+                requestId: payload.requestId,
+                error: message,
+            });
+        }
+    });
     process.on("SIGINT", () => {
         console.log(chalk.gray("\nShutting down worker…"));
         abortAgent();

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@oblivihon/steer",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI worker for Steer — run local Cursor agents for multiplayer sessions",
   "type": "module",
   "bin": {
     "steer": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc",