relayrun 0.1.0 → 0.1.1

package/README.md

@@ -48,6 +48,7 @@ rather than wedging the session.
 |---|---|
 | `--repo <path>` | Repository to work in (default: current directory) |
 | `--api-key <key>` | Bill runs to this key instead of your Claude Code login |
+| `--model <id>` | Model to run (default: `claude-sonnet-5`) |
 | `--mock` | Scripted offline agent — see below |
 | `--session <id>` | Reattach to an existing session (needs `--token`) |
 | `--token <tok>` | Runner token for `--session` |
@@ -92,7 +93,12 @@ relayrun --session 8M2zrrx9Ng --token <runner-token>
 
 - Node.js >= 20.9.0
 - `git`, and a repository to run in
-- A Claude Code login or an Anthropic API key (unless using `--mock`)
+- **A Claude Code login or an Anthropic API key** (unless using `--mock`)
+
+A claude.ai browser session or the Claude Desktop app will *not* work — those
+are separate logins from Claude Code. If no credential is found, `relayrun`
+says so and exits before opening a session, rather than failing later in front
+of whoever you invited.
 
 ## License
 

package/dist/agent/run.js

@@ -4,9 +4,8 @@ import { detailForCall } from "./diff.js";
 import { resultText, summarizeToolCall, summarizeToolResult } from "./summarize.js";
 import { orientation } from "./orient.js";
 export async function runRealAgent(opts) {
-    const { emit, instruction, workingDir, signal, resume, apiKeyHelper } = opts;
+    const { emit, instruction, workingDir, signal, resume, apiKeyHelper, model } = opts;
     const pending = new Map();
-    const model = process.env.RELAY_MODEL ?? "claude-haiku-4-5";
     // The SDK wants an AbortController, but ownership of stopping a run belongs
     // to the runner, which already holds one. Bridge the two.
     const abort = new AbortController();

package/dist/cli.js

@@ -2,6 +2,7 @@
 import { execFile } from "node:child_process";
 import path from "node:path";
 import { promisify } from "node:util";
+import { findClaudeLogin, hasClaudeCli, noLoginGuidance } from "./login.js";
 import { createRepo } from "./repo.js";
 import { startRunner } from "./runner.js";
 import { apiKeyHelperPath, keyHint, looksLikeApiKey, SESSION_KEY_ENV, verifyApiKey, } from "./sessionKey.js";
@@ -16,6 +17,7 @@ const run = promisify(execFile);
  */
 const DEFAULT_SERVER = process.env.RELAY_SERVER ?? "https://relay-production-c9bd.up.railway.app";
 const DEFAULT_WEB = process.env.RELAY_WEB ?? "https://relay-web-green.vercel.app";
+const DEFAULT_MODEL = process.env.RELAY_MODEL ?? "claude-sonnet-5";
 const USAGE = `relayrun — run a Relay session against a repository on this machine
 
   relayrun [options]
@@ -27,6 +29,7 @@ const USAGE = `relayrun — run a Relay session against a repository on this mac
                          Costs nothing, but ignores what you type and replays
                          a fixed script. For UI work, not for real answers.
   --api-key <key>        Bill runs to this key instead of your Claude Code login
+  --model <id>           Model to run (default: ${DEFAULT_MODEL})
   --session <id>         Reattach to an existing session (requires --token)
   --token <token>        Runner token for --session
   --github-repo <o/n>    Open a PR here on publish
@@ -123,6 +126,14 @@ async function resolveCredentials(args) {
     if (!key) {
         // No explicit key: the SDK uses whatever this machine is already logged in
         // with, exactly as Claude Code does.
+        //
+        // Checked now rather than left to fail on the first instruction. By then a
+        // link has been printed and shared, so the failure lands in front of
+        // whoever was invited — and reads as "this tool is broken" rather than
+        // "you need to log in".
+        if ((await findClaudeLogin()) === "missing") {
+            throw new Error(noLoginGuidance(await hasClaudeCli()));
+        }
         return { mode: "real", keySource: "oauth", keyHint: null };
     }
     if (!looksLikeApiKey(key)) {
@@ -171,6 +182,7 @@ async function main() {
     console.log(`\n  repo     ${path.basename(sourcePath)}  (${sourcePath})`);
     console.log(`  agent    ${billing}`);
     console.log(`  session  ${id}`);
+    console.log(`  shared   transcript only — code, keys and files stay on this machine`);
     console.log(`\n  Share this link:\n    ${new URL(`/session/${id}`, webUrl)}\n`);
     if (!existing) {
         console.log(`  To reattach after a restart:\n    relayrun --session ${id} --token ${runnerToken}\n`);
@@ -184,6 +196,7 @@ async function main() {
         keySource: credentials.keySource,
         keyHint: credentials.keyHint,
         apiKeyHelper: credentials.apiKeyHelper,
+        model: str(args, "model") ?? DEFAULT_MODEL,
     });
 }
 main().catch((err) => {

package/dist/login.js

@@ -0,0 +1,81 @@
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+const run = promisify(execFile);
+// Probed for existence only. `security` prints the secret itself just for -w,
+// which is deliberately not passed — nothing here needs the credential, only
+// the knowledge that one exists.
+const KEYCHAIN_SERVICE = "Claude Code-credentials";
+const PROBE_TIMEOUT_MS = 5_000;
+export async function findClaudeLogin() {
+    if (process.platform === "darwin") {
+        try {
+            await run("security", ["find-generic-password", "-s", KEYCHAIN_SERVICE], {
+                timeout: PROBE_TIMEOUT_MS,
+            });
+            return "found";
+        }
+        catch {
+            return "missing";
+        }
+    }
+    if (process.platform === "linux") {
+        return existsSync(path.join(homedir(), ".claude", ".credentials.json"))
+            ? "found"
+            : "missing";
+    }
+    return "unknown";
+}
+/** Whether the Claude Code CLI is on PATH, so the advice can skip an install step. */
+export async function hasClaudeCli() {
+    try {
+        await run("command", ["-v", "claude"], { shell: true, timeout: PROBE_TIMEOUT_MS });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Printed instead of a session link when no credential is found.
+ *
+ * Line one carries no indent because the caller's error handler adds it; the
+ * rest is indented here.
+ *
+ * Two variants because the install step is noise for the many people who
+ * already have the CLI and simply are not signed in — telling them to install
+ * something they have reads as advice that hasn't looked at their machine.
+ *
+ * There is deliberately no "click here to log in" link: the sign-in is an
+ * OAuth flow the CLI has to start itself, since it generates the challenge and
+ * receives the callback that writes the credential. No static URL can do it.
+ */
+export function noLoginGuidance(cliInstalled) {
+    const signIn = cliInstalled
+        ? `     1  Sign in to Claude Code                              (recommended)
+          claude              → sign in, then re-run relayrun
+          The CLI is already installed here — it just isn't signed in.`
+        : `     1  Install and sign in to Claude Code                  (recommended)
+          npm i -g @anthropic-ai/claude-code
+          claude              → sign in, then re-run relayrun
+          Setup guide: https://docs.claude.com/en/docs/claude-code/setup`;
+    return `No Claude credential found on this machine
+
+     relayrun ships no credentials of its own. It runs Claude on your machine,
+     with your access, billed to your account — so it needs one of these first:
+
+${signIn}
+
+     2  Use an Anthropic API key
+          relayrun --api-key sk-ant-...
+          Create one at https://console.anthropic.com/settings/keys
+
+     3  See how it works without spending anything
+          relayrun --mock     → scripted demo, ignores your instructions
+
+     Signing in through the Claude Code VS Code extension works too — it shares
+     the same credential. A claude.ai browser session or the Claude Desktop app
+     does not.`;
+}

package/dist/runner.js

@@ -47,6 +47,7 @@ export function startRunner(opts) {
                     signal: abort.signal,
                     resume,
                     apiKeyHelper: opts.apiKeyHelper,
+                    model: opts.model,
                 });
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relayrun",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Run a Relay session against a repository on your own machine — everyone with the link watches the agent work, one person drives.",
   "keywords": [
     "claude",