@kurtel/cli 0.1.0 → 0.1.3

package/dist/commands/auth.js

@@ -1,35 +1,95 @@
 import { c, symbols } from "../ui/colors.js";
 import { Spinner, sleep } from "../ui/spinner.js";
-import { loadConfig, saveConfig } from "../lib/config.js";
-import { previewNotice } from "./_shared.js";
+import { loadConfig, saveSession, clearSession } from "../lib/config.js";
+import { startDeviceAuth, pollDeviceAuth } from "../lib/api.js";
+import { openBrowser } from "../lib/browser.js";
 export async function loginCommand() {
     const config = loadConfig();
-    if (config.loggedIn) {
-        console.log(`${symbols.check} Already signed in as ${c.indigo(config.account ?? "you@example.com")}.`);
+    if (config.loggedIn && config.token) {
+        console.log(`${symbols.check} Already signed in as ${c.indigo(config.account ?? "your account")}${config.organization ? c.dim(` · ${config.organization}`) : ""}.`);
+        console.log(`${c.dim("Run")} ${c.indigo("kurtel logout")} ${c.dim("to switch accounts.")}`);
         return;
     }
+    // 1. Begin the device flow.
+    let session;
+    const startSpin = new Spinner("Requesting a device code…").start();
+    try {
+        session = await startDeviceAuth();
+        startSpin.stop();
+    }
+    catch (e) {
+        startSpin.fail(`Couldn't reach Kurtel: ${e instanceof Error ? e.message : String(e)}`);
+        console.log(`${c.dim("Check your connection, or set")} ${c.indigo("KURTEL_API_URL")} ${c.dim("for local dev.")}`);
+        process.exitCode = 1;
+        return;
+    }
+    // 2. Show the URL + code, try to open the browser.
     console.log("");
-    console.log(`${c.indigo(symbols.arrow)} Sign in to Kurtel — we'll open your browser to authorize.`);
-    const fakeUrl = "https://kurtel.ai/cli/auth?code=KRTL-PREVIEW";
-    console.log(`  ${c.dim(fakeUrl)}`);
+    console.log(`${c.indigo(symbols.arrow)} Open this URL to authorize:`);
+    console.log(`  ${c.bold(session.verification_url)}`);
     console.log("");
-    const spin = new Spinner("Waiting for browser authorization…").start();
-    await sleep(1200);
-    spin.info("Authorization step is a preview stub.");
-    config.loggedIn = true;
-    config.account = "you@example.com";
-    saveConfig(config);
-    console.log(`${symbols.check} Signed in as ${c.indigo(config.account)} ${c.dim("(local preview session)")}`);
-    previewNotice("Authentication");
+    console.log(`${c.dim("Device code:")} ${c.indigo(session.user_code)}`);
+    console.log("");
+    const opened = openBrowser(session.verification_url);
+    if (opened) {
+        console.log(c.dim("Opening your browser…"));
+    }
+    // 3. Poll until authorized / expired / timeout.
+    const spin = new Spinner("Waiting for you to authorize in the browser…").start();
+    const intervalMs = Math.max(1, session.interval) * 1000;
+    const deadline = Date.now() + session.expires_in * 1000;
+    while (Date.now() < deadline) {
+        await sleep(intervalMs);
+        let res;
+        try {
+            res = await pollDeviceAuth(session.device_code);
+        }
+        catch {
+            continue; // transient network error — keep polling
+        }
+        if (res.status === "authorized") {
+            saveSession({
+                token: res.token,
+                account: res.account,
+                organization: res.organization,
+            });
+            spin.succeed(`Signed in as ${c.indigo(res.account ?? "your account")}${res.organization ? c.dim(` · ${res.organization}`) : ""}`);
+            console.log(c.dim("You can close the browser tab."));
+            return;
+        }
+        if (res.status === "denied") {
+            spin.fail("Authorization was denied.");
+            process.exitCode = 1;
+            return;
+        }
+        if (res.status === "expired" || res.status === "not_found" || res.status === "used") {
+            spin.fail("This login request expired. Run `kurtel login` again.");
+            process.exitCode = 1;
+            return;
+        }
+        // status === "pending" → keep waiting
+    }
+    spin.fail("Timed out waiting for authorization. Run `kurtel login` again.");
+    process.exitCode = 1;
 }
 export async function logoutCommand() {
     const config = loadConfig();
     if (!config.loggedIn) {
-        console.log(`${c.dim("You're not signed in.")}`);
+        console.log(c.dim("You're not signed in."));
         return;
     }
-    config.loggedIn = false;
-    delete config.account;
-    saveConfig(config);
+    clearSession();
     console.log(`${symbols.check} Signed out.`);
 }
+export function whoamiCommand() {
+    const config = loadConfig();
+    if (!config.loggedIn || !config.token) {
+        console.log(`${c.dim("Not signed in. Run")} ${c.indigo("kurtel login")}${c.dim(".")}`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`${c.indigo(symbols.info)} ${c.white(config.account ?? "unknown account")}`);
+    if (config.organization) {
+        console.log(`${c.gray("org")} ${c.white(config.organization)}`);
+    }
+}

package/dist/commands/run.js

@@ -1,27 +1,41 @@
 import { c, symbols } from "../ui/colors.js";
-import { Spinner, sleep } from "../ui/spinner.js";
-import { previewNotice } from "./_shared.js";
+import { createRun, AuthError } from "../lib/api.js";
+import { isEngineName } from "../lib/engines.js";
 export async function runCommand(task, opts) {
     if (!task || task.trim() === "") {
-        console.log(`${c.red(symbols.cross)} Provide a task, e.g. ${c.indigo('kurtel run "fix flaky auth test"')}`);
+        console.log(`${c.red(symbols.cross)} Provide a task, e.g. ${c.indigo('kurtel run "fix the flaky auth test"')}`);
         process.exitCode = 1;
         return;
     }
-    const id = "agent-" + Math.random().toString(16).slice(2, 6);
-    const repo = opts.repo ?? "(current repo)";
-    console.log("");
-    console.log(`${c.gray("task")}   ${c.white(task)}`);
-    console.log(`${c.gray("repo")}   ${c.white(repo)}`);
-    console.log(`${c.gray("branch")} ${c.white(opts.branch ?? "main")}`);
-    console.log("");
-    const spin = new Spinner("Provisioning isolated sandbox…").start();
-    await sleep(700);
-    spin.update("Booting agent (codex + claude-code)…");
-    await sleep(700);
-    spin.update("Cloning repository into sandbox…");
-    await sleep(600);
-    spin.succeed(`Launched ${c.indigo(id)} ${c.dim(`(${opts.detach ? "detached" : "attached"})`)}`);
-    console.log("");
-    previewNotice("Launching agents");
-    console.log(`${c.dim("Once connected, follow it with")} ${c.indigo(`kurtel logs ${id}`)}${c.dim(".")}`);
+    if (opts.engine && !isEngineName(opts.engine)) {
+        console.log(`${c.red(symbols.cross)} Unknown engine ${c.white(opts.engine)}. Use ${c.indigo("claude-code")} or ${c.indigo("codex")}.`);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const run = await createRun({
+            task,
+            repo: opts.repo,
+            branch: opts.branch,
+            engine: opts.engine,
+        });
+        console.log("");
+        console.log(`${symbols.check} Launched ${c.indigo(run.id)}`);
+        console.log(`${c.gray("task")}    ${c.white(run.task)}`);
+        console.log(`${c.gray("engine")}  ${c.white(run.engine)}`);
+        if (run.repo)
+            console.log(`${c.gray("repo")}    ${c.white(run.repo)}`);
+        console.log(`${c.gray("status")}  ${c.indigo(run.status)}`);
+        console.log("");
+        console.log(`${c.dim("Follow it with")} ${c.indigo(`kurtel logs ${run.id} --follow`)}`);
+    }
+    catch (e) {
+        if (e instanceof AuthError) {
+            console.log(`${c.red(symbols.cross)} ${e.message}`);
+        }
+        else {
+            console.log(`${c.red(symbols.cross)} Failed to launch: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        process.exitCode = 1;
+    }
 }

package/dist/commands/runs.js

@@ -0,0 +1,54 @@
+import { c } from "../ui/colors.js";
+import { listRuns, AuthError } from "../lib/api.js";
+function pad(s, width) {
+    // eslint-disable-next-line no-control-regex
+    const len = s.replace(/\x1b\[[0-9;]*m/g, "").length;
+    return s + " ".repeat(Math.max(0, width - len));
+}
+function statusLabel(status) {
+    switch (status) {
+        case "running": return c.indigo("● running");
+        case "queued": return c.gray("○ queued");
+        case "succeeded": return c.green("✔ done");
+        case "failed": return c.red("✖ failed");
+        case "canceled": return c.yellow("• canceled");
+        default: return status;
+    }
+}
+function ago(iso) {
+    const diff = Date.now() - new Date(iso).getTime();
+    const m = Math.floor(diff / 60000);
+    if (m < 1)
+        return "just now";
+    if (m < 60)
+        return `${m}m ago`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h ago`;
+    return `${Math.floor(h / 24)}d ago`;
+}
+export async function runsCommand() {
+    try {
+        const { runs } = await listRuns();
+        if (!runs.length) {
+            console.log(c.dim("No runs yet. Launch one with `kurtel run \"…\"`."));
+            return;
+        }
+        console.log("");
+        console.log(pad(c.gray("ID"), 14) + pad(c.gray("STATUS"), 14) +
+            pad(c.gray("ENGINE"), 14) + pad(c.gray("AGE"), 10) + c.gray("TASK"));
+        for (const r of runs) {
+            console.log(pad(c.indigo(r.id), 14) + pad(statusLabel(r.status), 14) +
+                pad(c.dim(r.engine), 14) + pad(c.dim(ago(r.created_at)), 10) +
+                c.white(r.task.length > 50 ? r.task.slice(0, 49) + "…" : r.task));
+        }
+        console.log("");
+    }
+    catch (e) {
+        if (e instanceof AuthError)
+            console.log(`${c.red("✖")} ${e.message}`);
+        else
+            console.log(`${c.red("✖")} ${e instanceof Error ? e.message : String(e)}`);
+        process.exitCode = 1;
+    }
+}

package/dist/commands/runtime.js

@@ -1,50 +1,70 @@
-import { c } from "../ui/colors.js";
-import { Spinner, sleep } from "../ui/spinner.js";
-import { SAMPLE_AGENTS, statusColor, levelBadge } from "../lib/agents.js";
-import { previewNotice } from "./_shared.js";
-function findAgent(id) {
-    return SAMPLE_AGENTS.find((a) => a.id === id) ?? SAMPLE_AGENTS[0];
+import { c, symbols } from "../ui/colors.js";
+import { sleep } from "../ui/spinner.js";
+import { getRun, getRunLogs, cancelRun, AuthError } from "../lib/api.js";
+function handleErr(e) {
+    if (e instanceof AuthError)
+        console.log(`${c.red(symbols.cross)} ${e.message}`);
+    else
+        console.log(`${c.red(symbols.cross)} ${e instanceof Error ? e.message : String(e)}`);
+    process.exitCode = 1;
 }
-const FAKE_LOG_LINES = [
-    ["plan", "Reading repository structure and conventions"],
-    ["plan", "Drafting change set across 4 files"],
-    ["edit", "src/webhooks/handler.ts — add idempotency guard"],
-    ["test", "Running test suite in sandbox"],
-    ["learn", "Captured pattern: prefer repository-scoped idempotency keys"],
-    ["done", "Opened pull request #482"],
-];
-export async function logsCommand(id) {
-    const agent = findAgent(id);
-    console.log(`\n${c.dim("Streaming logs for")} ${c.indigo(agent.id)} ${c.dim(`· ${agent.repo}`)}\n`);
-    for (const [tag, msg] of FAKE_LOG_LINES) {
-        const ts = c.dim(new Date().toLocaleTimeString());
-        const label = tag === "learn"
-            ? c.cyan(`[${tag}]`)
-            : tag === "done"
-                ? c.green(`[${tag}]`)
-                : c.indigo(`[${tag}]`);
-        console.log(`${ts} ${label} ${c.white(msg)}`);
-        await sleep(450);
+function statusLabel(status) {
+    switch (status) {
+        case "running": return c.indigo("● running");
+        case "queued": return c.gray("○ queued");
+        case "succeeded": return c.green("✔ succeeded");
+        case "failed": return c.red("✖ failed");
+        case "canceled": return c.yellow("• canceled");
+        default: return status;
     }
-    console.log("");
-    previewNotice("Live logs");
 }
-export function statusCommand(id) {
-    const a = findAgent(id);
-    console.log("");
-    console.log(`${c.gray("id")}       ${c.indigo(a.id)}`);
-    console.log(`${c.gray("task")}     ${c.white(a.task)}`);
-    console.log(`${c.gray("repo")}     ${c.white(a.repo)}`);
-    console.log(`${c.gray("level")}    ${levelBadge(a.level)}`);
-    console.log(`${c.gray("status")}   ${statusColor(a.status)}`);
-    console.log(`${c.gray("progress")} ${c.white(a.progress + "%")}`);
-    console.log("");
-    previewNotice("Agent status");
+const TERMINAL = ["succeeded", "failed", "canceled"];
+export async function logsCommand(id, opts = {}) {
+    try {
+        let printed = 0;
+        for (;;) {
+            const { status, logs } = await getRunLogs(id);
+            if (logs.length > printed) {
+                process.stdout.write(logs.slice(printed));
+                printed = logs.length;
+            }
+            if (!opts.follow || TERMINAL.includes(status)) {
+                console.log(`\n${statusLabel(status)}`);
+                return;
+            }
+            await sleep(1500);
+        }
+    }
+    catch (e) {
+        handleErr(e);
+    }
+}
+export async function statusCommand(id) {
+    try {
+        const run = await getRun(id);
+        console.log("");
+        console.log(`${c.gray("id")}       ${c.indigo(run.id)}`);
+        console.log(`${c.gray("task")}     ${c.white(run.task)}`);
+        if (run.repo)
+            console.log(`${c.gray("repo")}     ${c.white(run.repo)}`);
+        console.log(`${c.gray("engine")}   ${c.white(run.engine)}`);
+        console.log(`${c.gray("status")}   ${statusLabel(run.status)}`);
+        if (run.result?.summary)
+            console.log(`${c.gray("summary")}  ${c.white(run.result.summary)}`);
+        if (run.error)
+            console.log(`${c.gray("error")}    ${c.red(run.error)}`);
+        console.log("");
+    }
+    catch (e) {
+        handleErr(e);
+    }
 }
 export async function stopCommand(id) {
-    const a = findAgent(id);
-    const spin = new Spinner(`Stopping ${c.indigo(a.id)} and tearing down sandbox…`).start();
-    await sleep(800);
-    spin.succeed(`Stopped ${c.indigo(a.id)} ${c.dim("· sandbox destroyed")}`);
-    previewNotice("Stopping agents");
+    try {
+        await cancelRun(id);
+        console.log(`${symbols.check} Canceled ${c.indigo(id)} ${c.dim("· sandbox torn down")}`);
+    }
+    catch (e) {
+        handleErr(e);
+    }
 }

package/dist/index.js

@@ -5,8 +5,9 @@ import { loadConfig } from "./lib/config.js";
 import { c, symbols } from "./ui/colors.js";
 import { startSession } from "./session/repl.js";
 import { runCommand } from "./commands/run.js";
-import { loginCommand, logoutCommand } from "./commands/auth.js";
+import { loginCommand, logoutCommand, whoamiCommand } from "./commands/auth.js";
 import { agentsCommand } from "./commands/agents.js";
+import { runsCommand } from "./commands/runs.js";
 import { logsCommand, statusCommand, stopCommand } from "./commands/runtime.js";
 import { configCommand } from "./commands/config.js";
 import { initCommand, doctorCommand } from "./commands/project.js";
@@ -26,12 +27,16 @@ program
     .command("run")
     .description("Launch a cloud agent on a task")
     .argument("[task...]", "What you want the agent to do")
-    .option("-r, --repo <repo>", "Target repository")
+    .option("-r, --repo <repo>", "Target repository (owner/name or URL)")
     .option("-b, --branch <branch>", "Base branch", "main")
-    .option("-d, --detach", "Launch without attaching to logs", false)
+    .option("-e, --engine <engine>", "Engine: claude-code | codex")
     .action(async (taskParts, opts) => {
     await runCommand((taskParts ?? []).join(" "), opts);
 });
+program
+    .command("runs")
+    .description("List your recent runs")
+    .action(() => runsCommand());
 program
     .command("agents")
     .alias("ps")
@@ -39,13 +44,14 @@ program
     .action(() => agentsCommand());
 program
     .command("logs")
-    .description("Stream an agent's logs")
-    .argument("<id>", "Agent id (e.g. agent-7f3a)")
-    .action(async (id) => logsCommand(id));
+    .description("Stream a run's logs")
+    .argument("<id>", "Run id")
+    .option("-f, --follow", "Keep streaming until the run finishes", false)
+    .action(async (id, opts) => logsCommand(id, opts));
 program
     .command("status")
-    .description("Show an agent's status")
-    .argument("<id>", "Agent id")
+    .description("Show a run's status")
+    .argument("<id>", "Run id")
     .action((id) => statusCommand(id));
 program
     .command("stop")
@@ -60,6 +66,10 @@ program
     .command("logout")
     .description("Sign out")
     .action(async () => logoutCommand());
+program
+    .command("whoami")
+    .description("Show the signed-in account")
+    .action(() => whoamiCommand());
 program
     .command("config")
     .description("View or change local configuration")

package/dist/lib/api.js

@@ -0,0 +1,78 @@
+import { apiUrl } from "./config.js";
+async function postJSON(path, body) {
+    const res = await fetch(`${apiUrl()}${path}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    const text = await res.text();
+    let data = {};
+    try {
+        data = text ? JSON.parse(text) : {};
+    }
+    catch {
+        // non-JSON response
+    }
+    if (!res.ok && res.status >= 500) {
+        const msg = data?.error ?? `server error (${res.status})`;
+        throw new Error(msg);
+    }
+    return data;
+}
+export function startDeviceAuth() {
+    return postJSON("/api/cli/auth/start", {});
+}
+export function pollDeviceAuth(deviceCode) {
+    return postJSON("/api/cli/auth/poll", {
+        device_code: deviceCode,
+    });
+}
+// ── Authenticated API (uses the stored CLI token) ──────────────────────────
+import { loadConfig } from "./config.js";
+export class AuthError extends Error {
+}
+async function authed(method, path, body) {
+    const token = loadConfig().token;
+    if (!token)
+        throw new AuthError("Not signed in. Run `kurtel login`.");
+    const res = await fetch(`${apiUrl()}${path}`, {
+        method,
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${token}`,
+        },
+        body: body === undefined ? undefined : JSON.stringify(body),
+    });
+    const text = await res.text();
+    let data = {};
+    try {
+        data = text ? JSON.parse(text) : {};
+    }
+    catch { }
+    if (res.status === 401) {
+        throw new AuthError("Your session is invalid or expired. Run `kurtel login`.");
+    }
+    if (!res.ok) {
+        const msg = data?.error ?? `error ${res.status}`;
+        throw new Error(msg);
+    }
+    return data;
+}
+export function verifyToken() {
+    return authed("GET", "/api/cli/me");
+}
+export function createRun(input) {
+    return authed("POST", "/api/runs", input);
+}
+export function listRuns() {
+    return authed("GET", "/api/runs");
+}
+export function getRun(id) {
+    return authed("GET", `/api/runs/${id}`);
+}
+export function getRunLogs(id) {
+    return authed("GET", `/api/runs/${id}/logs`);
+}
+export function cancelRun(id) {
+    return authed("DELETE", `/api/runs/${id}`);
+}

package/dist/lib/browser.js

@@ -0,0 +1,28 @@
+import { spawn } from "node:child_process";
+// Best-effort: open a URL in the default browser across macOS / Windows / Linux.
+export function openBrowser(url) {
+    try {
+        const platform = process.platform;
+        let command;
+        let args;
+        if (platform === "darwin") {
+            command = "open";
+            args = [url];
+        }
+        else if (platform === "win32") {
+            command = "cmd";
+            args = ["/c", "start", "", url];
+        }
+        else {
+            command = "xdg-open";
+            args = [url];
+        }
+        const child = spawn(command, args, { stdio: "ignore", detached: true });
+        child.on("error", () => { });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/lib/config.js

@@ -1,6 +1,31 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+// Where the CLI talks to. Override with KURTEL_API_URL for local dev, e.g.
+//   KURTEL_API_URL=http://localhost:3000 kurtel login
+export function apiUrl() {
+    return (process.env.KURTEL_API_URL ??
+        loadConfig().apiUrl ??
+        "htt");
+}
+export function saveSession(session) {
+    const config = loadConfig();
+    config.loggedIn = true;
+    config.token = session.token;
+    if (session.account)
+        config.account = session.account;
+    if (session.organization)
+        config.organization = session.organization;
+    saveConfig(config);
+}
+export function clearSession() {
+    const config = loadConfig();
+    config.loggedIn = false;
+    delete config.token;
+    delete config.account;
+    delete config.organization;
+    saveConfig(config);
+}
 const DIR = join(homedir(), ".kurtel");
 const FILE = join(DIR, "config.json");
 const DEFAULTS = {

package/dist/lib/engines.js

@@ -0,0 +1,4 @@
+export const ENGINE_NAMES = ["claude-code", "codex"];
+export function isEngineName(v) {
+    return ENGINE_NAMES.includes(v);
+}

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@kurtel/cli",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Launch self-improving coding agents in the cloud — the Kurtel CLI.",
   "type": "module",
   "bin": {
     "kurtel": "dist/index.js"
   },
-  "publishConfig": { "access": "public" },
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "dist"
   ],