@teammates/cli 0.3.1 → 0.3.3

package/dist/cli.js

@@ -7,390 +7,27 @@
  *   teammates --adapter codex     Use a specific agent adapter
  *   teammates --dir <path>        Override .teammates/ location
  */
-import { exec as execCb, } from "node:child_process";
+import { exec as execCb, execSync, spawn } from "node:child_process";
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { mkdir, readdir, rm, stat, unlink } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { createInterface } from "node:readline";
-import { App, ChatView, Control, concat, esc, Interview, pen, renderMarkdown, StyledText, stripAnsi, } from "@teammates/consolonia";
+import { App, ChatView, concat, esc, Interview, pen, renderMarkdown, stripAnsi, } from "@teammates/consolonia";
 import chalk from "chalk";
 import ora from "ora";
 import { syncRecallIndex } from "./adapter.js";
-import { CliProxyAdapter, PRESETS } from "./adapters/cli-proxy.js";
-import { EchoAdapter } from "./adapters/echo.js";
+import { AnimatedBanner } from "./banner.js";
+import { findTeammatesDir, PKG_VERSION, parseCliArgs, printUsage, resolveAdapter, } from "./cli-args.js";
 import { findAtMention, isImagePath, relativeTime, wrapLine, } from "./cli-utils.js";
 import { buildWisdomPrompt, compactEpisodic } from "./compact.js";
 import { PromptInput } from "./console/prompt-input.js";
 import { buildTitle } from "./console/startup.js";
 import { buildImportAdaptationPrompt, copyTemplateFiles, getOnboardingPrompt, importTeammates, } from "./onboard.js";
 import { Orchestrator } from "./orchestrator.js";
-import { colorToHex, theme } from "./theme.js";
-// ─── Version ─────────────────────────────────────────────────────────
-const PKG_VERSION = (() => {
-    try {
-        const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
-        return pkg.version ?? "0.0.0";
-    }
-    catch {
-        return "0.0.0";
-    }
-})();
-// ─── Argument parsing ────────────────────────────────────────────────
-const args = process.argv.slice(2);
-function getFlag(name) {
-    const idx = args.indexOf(`--${name}`);
-    if (idx >= 0) {
-        args.splice(idx, 1);
-        return true;
-    }
-    return false;
-}
-function getOption(name) {
-    const idx = args.indexOf(`--${name}`);
-    if (idx >= 0 && idx + 1 < args.length) {
-        const val = args[idx + 1];
-        args.splice(idx, 2);
-        return val;
-    }
-    return undefined;
-}
-const showHelp = getFlag("help");
-const modelOverride = getOption("model");
-const dirOverride = getOption("dir");
-// First remaining positional arg is the agent name (default: echo)
-const adapterName = args.shift() ?? "echo";
-// Everything left passes through to the agent CLI
-const agentPassthrough = [...args];
-args.length = 0;
-// ─── Helpers ─────────────────────────────────────────────────────────
-async function findTeammatesDir() {
-    if (dirOverride)
-        return resolve(dirOverride);
-    let dir = process.cwd();
-    while (true) {
-        const candidate = join(dir, ".teammates");
-        try {
-            const s = await stat(candidate);
-            if (s.isDirectory())
-                return candidate;
-        }
-        catch {
-            /* keep looking */
-        }
-        const parent = resolve(dir, "..");
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    return null;
-}
-async function resolveAdapter(name) {
-    if (name === "echo")
-        return new EchoAdapter();
-    // GitHub Copilot SDK adapter — lazy-loaded to avoid pulling in
-    // @github/copilot-sdk (and vscode-jsonrpc) when not needed.
-    if (name === "copilot") {
-        const { CopilotAdapter } = await import("./adapters/copilot.js");
-        return new CopilotAdapter({
-            model: modelOverride,
-        });
-    }
-    // All other adapters go through the CLI proxy
-    if (PRESETS[name]) {
-        return new CliProxyAdapter({
-            preset: name,
-            model: modelOverride,
-            extraFlags: agentPassthrough,
-        });
-    }
-    const available = ["echo", "copilot", ...Object.keys(PRESETS)].join(", ");
-    console.error(chalk.red(`Unknown adapter: ${name}`));
-    console.error(`Available adapters: ${available}`);
-    process.exit(1);
-}
-// WordwheelItem is now DropdownItem from @teammates/consolonia
-// ── Themed pen shortcuts ────────────────────────────────────────────
-//
-// Thin wrappers that read from the active theme() at call time, so
-// every styled span picks up the current palette automatically.
-const tp = {
-    accent: (s) => pen.fg(theme().accent)(s),
-    accentBright: (s) => pen.fg(theme().accentBright)(s),
-    accentDim: (s) => pen.fg(theme().accentDim)(s),
-    text: (s) => pen.fg(theme().text)(s),
-    muted: (s) => pen.fg(theme().textMuted)(s),
-    dim: (s) => pen.fg(theme().textDim)(s),
-    success: (s) => pen.fg(theme().success)(s),
-    warning: (s) => pen.fg(theme().warning)(s),
-    error: (s) => pen.fg(theme().error)(s),
-    info: (s) => pen.fg(theme().info)(s),
-    bold: (s) => pen.bold.fg(theme().text)(s),
-};
-/**
- * Custom banner widget that plays a reveal animation inside the
- * consolonia rendering loop (alternate screen already active).
- *
- * Phases:
- *  1. Reveal "teammates" letter by letter in block font
- *  2. Collapse to "TM" + stats panel
- *  3. Fade in teammate roster
- *  4. Fade in command reference
- */
-class AnimatedBanner extends Control {
-    _lines = [];
-    _info;
-    _phase = "idle";
-    _inner;
-    _timer = null;
-    _onDirty = null;
-    // Spelling state
-    _word = "teammates";
-    _charIndex = 0;
-    _builtTop = "";
-    _builtBot = "";
-    _versionStr = ` v${PKG_VERSION}`;
-    _versionIndex = 0;
-    // Roster/command reveal state
-    _revealIndex = 0;
-    /** When true, the animation pauses after roster reveal (before commands). */
-    _held = false;
-    // The final lines (built once, revealed progressively)
-    _finalLines = [];
-    // Line index where roster starts and commands start
-    _rosterStart = 0;
-    _commandsStart = 0;
-    static GLYPHS = {
-        t: ["▀█▀", " █ "],
-        e: ["█▀▀", "██▄"],
-        a: ["▄▀█", "█▀█"],
-        m: ["█▀▄▀█", "█ ▀ █"],
-        s: ["█▀", "▄█"],
-    };
-    constructor(info) {
-        super();
-        this._info = info;
-        this._inner = new StyledText({ lines: [], wrap: true });
-        this.addChild(this._inner);
-        this._buildFinalLines();
-    }
-    /** Set a callback that fires when the banner needs a re-render. */
-    set onDirty(fn) {
-        this._onDirty = fn;
-    }
-    /** Start the animation sequence. */
-    start() {
-        this._phase = "spelling";
-        this._charIndex = 0;
-        this._builtTop = "";
-        this._builtBot = "";
-        this._tick();
-    }
-    _buildFinalLines() {
-        const info = this._info;
-        const [tmTop, tmBot] = buildTitle("tm");
-        const tmPad = " ".repeat(tmTop.length);
-        const gap = "   ";
-        const lines = [];
-        // TM logo row 1 + adapter info
-        lines.push(concat(tp.accent(tmTop), tp.text(gap + info.adapterName), tp.muted(` · ${info.teammateCount} teammate${info.teammateCount === 1 ? "" : "s"}`), tp.muted(` · v${PKG_VERSION}`)));
-        // TM logo row 2 + cwd
-        lines.push(concat(tp.accent(tmBot), tp.muted(gap + info.cwd)));
-        // Recall status (bundled as dependency)
-        lines.push(concat(tp.text(tmPad + gap), tp.success("● "), tp.success("recall"), tp.muted(" bundled")));
-        // blank
-        lines.push("");
-        this._rosterStart = lines.length;
-        // Teammate roster
-        for (const t of info.teammates) {
-            lines.push(concat(tp.accent("  ● "), tp.accent(`@${t.name}`.padEnd(14)), tp.muted(t.role)));
-        }
-        // blank
-        lines.push("");
-        this._commandsStart = lines.length;
-        // Command reference (must match printBanner normal-mode layout)
-        const col1 = [
-            ["@mention", "assign to teammate"],
-            ["text", "auto-route task"],
-            ["[image]", "drag & drop images"],
-        ];
-        const col2 = [
-            ["/status", "teammates & queue"],
-            ["/compact", "compact memory"],
-            ["/retro", "run retrospective"],
-        ];
-        const col3 = [
-            ["/copy", "copy session text"],
-            ["/help", "all commands"],
-            ["/exit", "exit session"],
-        ];
-        for (let i = 0; i < col1.length; i++) {
-            lines.push(concat(tp.accent(`  ${col1[i][0].padEnd(12)}`), tp.muted(col1[i][1].padEnd(22)), tp.accent(col2[i][0].padEnd(12)), tp.muted(col2[i][1].padEnd(22)), tp.accent(col3[i][0].padEnd(12)), tp.muted(col3[i][1])));
-        }
-        this._finalLines = lines;
-    }
-    _tick() {
-        switch (this._phase) {
-            case "spelling": {
-                const ch = this._word[this._charIndex];
-                const g = AnimatedBanner.GLYPHS[ch];
-                if (g) {
-                    if (this._builtTop.length > 0) {
-                        this._builtTop += " ";
-                        this._builtBot += " ";
-                    }
-                    this._builtTop += g[0];
-                    this._builtBot += g[1];
-                }
-                this._lines = [
-                    concat(tp.accent(this._builtTop)),
-                    concat(tp.accent(this._builtBot)),
-                ];
-                this._apply();
-                this._charIndex++;
-                if (this._charIndex >= this._word.length) {
-                    this._phase = "version";
-                    this._versionIndex = 0;
-                    this._schedule(60);
-                }
-                else {
-                    this._schedule(60);
-                }
-                break;
-            }
-            case "version": {
-                // Type out version string character by character on the bottom row
-                this._versionIndex++;
-                const partial = this._versionStr.slice(0, this._versionIndex);
-                this._lines = [
-                    concat(tp.accent(this._builtTop)),
-                    concat(tp.accent(this._builtBot), tp.muted(partial)),
-                ];
-                this._apply();
-                if (this._versionIndex >= this._versionStr.length) {
-                    this._phase = "pause";
-                    this._schedule(600);
-                }
-                else {
-                    this._schedule(60);
-                }
-                break;
-            }
-            case "pause": {
-                // Brief pause before transitioning to compact view
-                this._phase = "compact";
-                this._schedule(800);
-                break;
-            }
-            case "compact": {
-                // Switch to TM + stats — show first 4 lines of final
-                this._lines = this._finalLines.slice(0, 4);
-                this._apply();
-                this._phase = "roster";
-                this._revealIndex = 0;
-                this._schedule(80);
-                break;
-            }
-            case "roster": {
-                // Reveal roster lines one at a time
-                const end = this._rosterStart + this._revealIndex + 1;
-                this._lines = [
-                    ...this._finalLines.slice(0, this._rosterStart),
-                    ...this._finalLines.slice(this._rosterStart, end),
-                ];
-                this._apply();
-                this._revealIndex++;
-                const rosterCount = this._commandsStart - 1 - this._rosterStart; // -1 for blank line
-                if (this._revealIndex >= rosterCount) {
-                    if (this._held) {
-                        // Pause here until releaseHold() is called
-                        this._phase = "roster-held";
-                    }
-                    else {
-                        this._phase = "commands";
-                        this._revealIndex = 0;
-                        this._schedule(80);
-                    }
-                }
-                else {
-                    this._schedule(40);
-                }
-                break;
-            }
-            case "commands": {
-                // Add the blank line between roster and commands, then reveal commands
-                const rosterEnd = this._commandsStart; // includes the blank line
-                const cmdEnd = this._commandsStart + this._revealIndex + 1;
-                this._lines = [
-                    ...this._finalLines.slice(0, rosterEnd),
-                    ...this._finalLines.slice(this._commandsStart, cmdEnd),
-                ];
-                this._apply();
-                this._revealIndex++;
-                const cmdCount = this._finalLines.length - this._commandsStart;
-                if (this._revealIndex >= cmdCount) {
-                    this._phase = "done";
-                }
-                else {
-                    this._schedule(30);
-                }
-                break;
-            }
-        }
-    }
-    _apply() {
-        this._inner.lines = this._lines;
-        this.invalidate();
-        if (this._onDirty)
-            this._onDirty();
-    }
-    _schedule(ms) {
-        this._timer = setTimeout(() => {
-            this._timer = null;
-            this._tick();
-        }, ms);
-    }
-    /**
-     * Hold the animation — it will pause after the roster phase and
-     * not reveal the command reference until releaseHold() is called.
-     */
-    hold() {
-        this._held = true;
-    }
-    /**
-     * Release the hold and continue to the commands phase.
-     * If the animation already reached the hold point, it resumes immediately.
-     */
-    releaseHold() {
-        this._held = false;
-        // If we're waiting at the hold point, resume
-        if (this._phase === "roster-held") {
-            this._phase = "commands";
-            this._revealIndex = 0;
-            this._schedule(80);
-        }
-    }
-    /** Cancel any pending animation timer. */
-    dispose() {
-        if (this._timer) {
-            clearTimeout(this._timer);
-            this._timer = null;
-        }
-    }
-    // ── Layout delegation ───────────────────────────────────────────
-    measure(constraint) {
-        const size = this._inner.measure(constraint);
-        this.desiredSize = size;
-        return size;
-    }
-    arrange(rect) {
-        this.bounds = rect;
-        this._inner.arrange(rect);
-    }
-    render(ctx) {
-        this._inner.render(ctx);
-    }
-}
+import { colorToHex, theme, tp } from "./theme.js";
+// ─── Parsed CLI arguments ────────────────────────────────────────────
+const cliArgs = parseCliArgs();
 // ─── REPL ────────────────────────────────────────────────────────────
 class TeammatesREPL {
     orchestrator;
@@ -453,6 +90,8 @@ class TeammatesREPL {
     /** Quoted reply text to expand on next submit. */
     _pendingQuotedReply = null;
     defaultFooter = null; // cached default footer content
+    /** Cached service statuses for banner + /configure. */
+    serviceStatuses = [];
     // ── Animated status tracker ─────────────────────────────────────
     activeTasks = new Map();
     statusTimer = null;
@@ -1136,14 +775,14 @@ class TeammatesREPL {
         const changes = proposals
             .map((p) => `- **Proposal ${p.index}: ${p.title}**\n  - Section: ${p.section}\n  - Before: ${p.before}\n  - After: ${p.after}`)
             .join("\n\n");
-        const applyPrompt = `The user approved the following SOUL.md changes from your retrospective. Apply them now.
-
-**Edit your SOUL.md file** (\`.teammates/${teammate}/SOUL.md\`) to incorporate these changes:
-
-${changes}
-
-After editing SOUL.md, record a brief summary of the retro outcome in your daily log: which proposals were approved and what changed.
-
+        const applyPrompt = `The user approved the following SOUL.md changes from your retrospective. Apply them now.
+
+**Edit your SOUL.md file** (\`.teammates/${teammate}/SOUL.md\`) to incorporate these changes:
+
+${changes}
+
+After editing SOUL.md, record a brief summary of the retro outcome in your daily log: which proposals were approved and what changed.
+
 Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily log.`;
         this.taskQueue.push({ type: "agent", teammate, task: applyPrompt });
         this.feedLine(concat(tp.muted("  Queued SOUL.md update for "), tp.accent(`@${teammate}`)));
@@ -1676,6 +1315,22 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
     };
     /** Build param-completion items for the current line, if any. */
     getParamItems(cmdName, argsBefore, partial) {
+        // Service name completion for /configure
+        if (cmdName === "configure" || cmdName === "config") {
+            const completedArgs = argsBefore.trim()
+                ? argsBefore.trim().split(/\s+/).length
+                : 0;
+            if (completedArgs > 0)
+                return [];
+            const lower = partial.toLowerCase();
+            return TeammatesREPL.CONFIGURABLE_SERVICES
+                .filter((s) => s.startsWith(lower))
+                .map((s) => ({
+                label: s,
+                description: `configure ${s}`,
+                completion: `/${cmdName} ${s} `,
+            }));
+        }
         const positions = TeammatesREPL.TEAMMATE_ARG_POSITIONS[cmdName];
         if (!positions)
             return [];
@@ -1899,8 +1554,11 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
     }
     // ─── Lifecycle ────────────────────────────────────────────────────
     async start() {
-        let teammatesDir = await findTeammatesDir();
-        const adapter = await resolveAdapter(this.adapterName);
+        let teammatesDir = await findTeammatesDir(cliArgs.dirOverride);
+        const adapter = await resolveAdapter(this.adapterName, {
+            modelOverride: cliArgs.modelOverride,
+            agentPassthrough: cliArgs.agentPassthrough,
+        });
         this.adapter = adapter;
         // No .teammates/ found — offer onboarding or solo mode
         if (!teammatesDir) {
@@ -1993,6 +1651,8 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 return currentValue;
             },
         });
+        // ── Detect service statuses ────────────────────────────────────────
+        this.serviceStatuses = this.detectServices();
         // ── Build animated banner for ChatView ─────────────────────────────
         const names = this.orchestrator.listTeammates();
         const reg = this.orchestrator.getRegistry();
@@ -2004,6 +1664,7 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 const t = reg.get(name);
                 return { name, role: t?.role ?? "" };
             }),
+            services: this.serviceStatuses,
         });
         // ── Create ChatView and Consolonia App ────────────────────────────
         const t = theme();
@@ -2402,7 +2063,20 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         this.feedLine(concat(tp.bold("  Teammates"), tp.muted(` v${PKG_VERSION}`)));
         this.feedLine(concat(tp.text(`  ${this.adapterName}`), tp.muted(` · ${teammates.length} teammate${teammates.length === 1 ? "" : "s"}`)));
         this.feedLine(`  ${process.cwd()}`);
-        this.feedLine(concat(tp.success("  ● recall"), tp.muted(" bundled")));
+        // Service status rows
+        for (const svc of this.serviceStatuses) {
+            const ok = svc.status === "bundled" || svc.status === "configured";
+            const icon = ok ? "● " : svc.status === "not-configured" ? "◐ " : "○ ";
+            const color = ok ? tp.success : tp.warning;
+            const label = svc.status === "bundled"
+                ? "bundled"
+                : svc.status === "configured"
+                    ? "configured"
+                    : svc.status === "not-configured"
+                        ? `not configured — /configure ${svc.name.toLowerCase()}`
+                        : `missing — /configure ${svc.name.toLowerCase()}`;
+            this.feedLine(concat(tp.text("  "), color(icon), color(svc.name), tp.muted(` ${label}`)));
+        }
         // Roster
         this.feedLine();
         for (const name of teammates) {
@@ -2455,6 +2129,200 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
         this.feedLine();
         this.refreshView();
     }
+    // ─── Service detection ────────────────────────────────────────────
+    detectGitHub() {
+        try {
+            execSync("gh --version", { stdio: "pipe" });
+        }
+        catch {
+            return "missing";
+        }
+        try {
+            execSync("gh auth status", { stdio: "pipe" });
+            return "configured";
+        }
+        catch {
+            return "not-configured";
+        }
+    }
+    detectServices() {
+        return [
+            { name: "recall", status: "bundled" },
+            { name: "GitHub", status: this.detectGitHub() },
+        ];
+    }
+    // ─── /configure command ─────────────────────────────────────────
+    static CONFIGURABLE_SERVICES = ["github"];
+    async cmdConfigure(argsStr) {
+        const serviceName = argsStr.trim().toLowerCase();
+        if (!serviceName) {
+            // Show status table
+            this.feedLine();
+            this.feedLine(tp.bold("  Services:"));
+            for (const svc of this.serviceStatuses) {
+                const ok = svc.status === "bundled" || svc.status === "configured";
+                const icon = ok ? "● " : svc.status === "not-configured" ? "◐ " : "○ ";
+                const color = ok ? tp.success : tp.warning;
+                const label = svc.status === "bundled"
+                    ? "bundled"
+                    : svc.status === "configured"
+                        ? "configured"
+                        : svc.status === "not-configured"
+                            ? "not configured"
+                            : "missing";
+                this.feedLine(concat(tp.text("    "), color(icon), color(svc.name.padEnd(12)), tp.muted(label)));
+            }
+            this.feedLine();
+            this.feedLine(tp.muted("  Use /configure [service] to set up a service"));
+            this.feedLine();
+            this.refreshView();
+            return;
+        }
+        if (serviceName === "github") {
+            await this.configureGitHub();
+        }
+        else {
+            this.feedLine(tp.warning(`  Unknown service: ${serviceName}`));
+            this.feedLine(tp.muted(`  Available: ${TeammatesREPL.CONFIGURABLE_SERVICES.join(", ")}`));
+            this.refreshView();
+        }
+    }
+    async configureGitHub() {
+        // Step 1: Check if gh is installed
+        let ghInstalled = false;
+        try {
+            execSync("gh --version", { stdio: "pipe" });
+            ghInstalled = true;
+        }
+        catch {
+            // not installed
+        }
+        if (!ghInstalled) {
+            this.feedLine();
+            this.feedLine(tp.warning("  GitHub CLI is not installed."));
+            this.feedLine();
+            const plat = process.platform;
+            let installCmd;
+            let installLabel;
+            if (plat === "win32") {
+                installCmd = "winget install --id GitHub.cli";
+                installLabel = "winget install --id GitHub.cli";
+            }
+            else if (plat === "darwin") {
+                installCmd = "brew install gh";
+                installLabel = "brew install gh";
+            }
+            else {
+                installCmd = "sudo apt install gh";
+                installLabel = "sudo apt install gh  (or see https://cli.github.com)";
+            }
+            this.feedLine(tp.text(`  Install:  ${installLabel}`));
+            this.feedLine();
+            // Ask user
+            const answer = await this.askInput("Run install command? [Y/n] ");
+            if (answer.toLowerCase() === "n") {
+                this.feedLine(tp.muted("  Skipped. Install manually and re-run /configure github"));
+                this.refreshView();
+                return;
+            }
+            // Spawn install in a visible subprocess
+            this.feedLine(tp.muted(`  Running: ${installCmd}`));
+            this.refreshView();
+            const installSuccess = await new Promise((res) => {
+                const parts = installCmd.split(" ");
+                const child = spawn(parts[0], parts.slice(1), {
+                    stdio: "inherit",
+                    shell: true,
+                });
+                child.on("error", () => res(false));
+                child.on("exit", (code) => res(code === 0));
+            });
+            if (!installSuccess) {
+                this.feedLine(tp.error("  Install failed. Please install manually from https://cli.github.com"));
+                this.refreshView();
+                return;
+            }
+            // Re-check
+            try {
+                execSync("gh --version", { stdio: "pipe" });
+                ghInstalled = true;
+                this.feedLine(tp.success("  ✓ GitHub CLI installed"));
+            }
+            catch {
+                this.feedLine(tp.error("  GitHub CLI still not found after install. You may need to restart your terminal."));
+                this.refreshView();
+                return;
+            }
+        }
+        else {
+            this.feedLine();
+            this.feedLine(tp.success("  ✓ GitHub CLI installed"));
+        }
+        // Step 2: Check auth
+        let authed = false;
+        try {
+            execSync("gh auth status", { stdio: "pipe" });
+            authed = true;
+        }
+        catch {
+            // not authenticated
+        }
+        if (!authed) {
+            this.feedLine(tp.muted("  Authentication needed — this will open your browser for GitHub OAuth."));
+            this.feedLine();
+            const answer = await this.askInput("Start authentication? [Y/n] ");
+            if (answer.toLowerCase() === "n") {
+                this.feedLine(tp.muted("  Skipped. Run /configure github when ready."));
+                this.refreshView();
+                this.updateServiceStatus("GitHub", "not-configured");
+                return;
+            }
+            this.feedLine(tp.muted("  Starting auth flow..."));
+            this.refreshView();
+            const authSuccess = await new Promise((res) => {
+                const child = spawn("gh", ["auth", "login", "--web", "--git-protocol", "https"], {
+                    stdio: "inherit",
+                    shell: true,
+                });
+                child.on("error", () => res(false));
+                child.on("exit", (code) => res(code === 0));
+            });
+            if (!authSuccess) {
+                this.feedLine(tp.error("  Authentication failed. Try again with /configure github"));
+                this.refreshView();
+                this.updateServiceStatus("GitHub", "not-configured");
+                return;
+            }
+            // Verify
+            try {
+                execSync("gh auth status", { stdio: "pipe" });
+                authed = true;
+            }
+            catch {
+                this.feedLine(tp.error("  Authentication could not be verified. Try again with /configure github"));
+                this.refreshView();
+                this.updateServiceStatus("GitHub", "not-configured");
+                return;
+            }
+        }
+        // Get username for confirmation
+        let username = "";
+        try {
+            username = execSync("gh api user --jq .login", { stdio: "pipe", encoding: "utf-8" }).trim();
+        }
+        catch {
+            // non-critical
+        }
+        this.feedLine(tp.success(`  ✓ GitHub configured${username ? ` — authenticated as @${username}` : ""}`));
+        this.feedLine();
+        this.refreshView();
+        this.updateServiceStatus("GitHub", "configured");
+    }
+    updateServiceStatus(name, status) {
+        const svc = this.serviceStatuses.find((s) => s.name === name);
+        if (svc)
+            svc.status = status;
+    }
     registerCommands() {
         const cmds = [
             {
@@ -2541,6 +2409,13 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
                 description: "Show current theme colors",
                 run: () => this.cmdTheme(),
             },
+            {
+                name: "configure",
+                aliases: ["config"],
+                usage: "/configure [service]",
+                description: "Configure external services (github)",
+                run: (args) => this.cmdConfigure(args),
+            },
             {
                 name: "exit",
                 aliases: ["q", "quit"],
@@ -3254,34 +3129,34 @@ Do NOT modify any other teammate's files. Only edit your own SOUL.md and daily l
             this.refreshView();
             return;
         }
-        const retroPrompt = `Run a structured self-retrospective. Review your SOUL.md, WISDOM.md, your last 2-3 weekly summaries (or last 7 daily logs if no weeklies exist), and any typed memories in your memory/ folder.
-
-Produce a response with these four sections:
-
-## 1. What's Working
-Things you do well, based on evidence from recent work. Patterns worth reinforcing or codifying into wisdom. Cite specific examples from daily logs or memories.
-
-## 2. What's Not Working
-Friction, recurring issues, or patterns that aren't serving the project. Be specific — cite examples from daily logs or memories if possible.
-
-## 3. Proposed SOUL.md Changes
-The core output. Each proposal is a **specific edit** to your SOUL.md. Use this exact format for each proposal:
-
-**Proposal N: <short title>**
-- **Section:** <which SOUL.md section to change, e.g. Boundaries, Core Principles, Ownership>
-- **Before:** <the current text to replace, or "(new entry)" if adding>
-- **After:** <the exact replacement text>
-- **Why:** <evidence from recent work justifying the change>
-
-Only propose changes to your own SOUL.md. If a change affects shared files, note that it needs a handoff.
-
-## 4. Questions for the Team
-Issues that can't be resolved unilaterally — they need input from other teammates or the user.
-
-**Rules:**
-- This is a self-review of YOUR work. Do not evaluate other teammates.
-- Evidence over opinion — cite specific examples.
-- No busywork — if everything is working well, say "all good, no changes." That's a valid outcome.
+        const retroPrompt = `Run a structured self-retrospective. Review your SOUL.md, WISDOM.md, your last 2-3 weekly summaries (or last 7 daily logs if no weeklies exist), and any typed memories in your memory/ folder.
+
+Produce a response with these four sections:
+
+## 1. What's Working
+Things you do well, based on evidence from recent work. Patterns worth reinforcing or codifying into wisdom. Cite specific examples from daily logs or memories.
+
+## 2. What's Not Working
+Friction, recurring issues, or patterns that aren't serving the project. Be specific — cite examples from daily logs or memories if possible.
+
+## 3. Proposed SOUL.md Changes
+The core output. Each proposal is a **specific edit** to your SOUL.md. Use this exact format for each proposal:
+
+**Proposal N: <short title>**
+- **Section:** <which SOUL.md section to change, e.g. Boundaries, Core Principles, Ownership>
+- **Before:** <the current text to replace, or "(new entry)" if adding>
+- **After:** <the exact replacement text>
+- **Why:** <evidence from recent work justifying the change>
+
+Only propose changes to your own SOUL.md. If a change affects shared files, note that it needs a handoff.
+
+## 4. Questions for the Team
+Issues that can't be resolved unilaterally — they need input from other teammates or the user.
+
+**Rules:**
+- This is a self-review of YOUR work. Do not evaluate other teammates.
+- Evidence over opinion — cite specific examples.
+- No busywork — if everything is working well, say "all good, no changes." That's a valid outcome.
 - Number each proposal (Proposal 1, Proposal 2, etc.) so the user can approve or reject individually.`;
         const label = targets.length > 1
             ? targets.map((n) => `@${n}`).join(", ")
@@ -3628,41 +3503,13 @@ Issues that can't be resolved unilaterally — they need input from other teamma
         this.refreshView();
     }
 }
-// ─── Usage (non-interactive) ─────────────────────────────────────────
-function printUsage() {
-    console.log(`
-${chalk.bold("@teammates/cli")} — Agent-agnostic teammate orchestrator
-
-${chalk.bold("Usage:")}
-  teammates <agent>          Launch session with an agent
-  teammates claude           Use Claude Code
-  teammates codex            Use OpenAI Codex
-  teammates aider            Use Aider
-
-${chalk.bold("Options:")}
-  --model <model>            Override the agent model
-  --dir <path>               Override .teammates/ location
-
-${chalk.bold("Agents:")}
-  claude     Claude Code CLI (requires 'claude' on PATH)
-  codex      OpenAI Codex CLI (requires 'codex' on PATH)
-  aider      Aider CLI (requires 'aider' on PATH)
-  echo       Test adapter — echoes prompts (no external agent)
-
-${chalk.bold("In-session:")}
-  @teammate <task>           Assign directly via @mention
-  <text>                     Auto-route to the best teammate
-  /status                    Session overview
-  /help                      All commands
-`.trim());
-}
 // ─── Main ────────────────────────────────────────────────────────────
 async function main() {
-    if (showHelp) {
+    if (cliArgs.showHelp) {
         printUsage();
         process.exit(0);
     }
-    const repl = new TeammatesREPL(adapterName);
+    const repl = new TeammatesREPL(cliArgs.adapterName);
     await repl.start();
 }
 main().catch((err) => {