agent-from-zero 0.35.2 → 0.35.4

package/dist/ink/app.js

@@ -4,12 +4,13 @@ import { statusCommand } from "../status.js";
 import React, { useState, useEffect, useRef } from "react";
 import { Box, Text, Static, useInput, useApp } from "ink";
 import chalk from "chalk";
-import { formatElapsed, renderMenu, MENU_HINT, formatModelChoices } from "../ui.js"; // status format + the SAME pure menu renderer the readline REPL uses
+import { COMPACTING_VERB, formatElapsed, renderMenu, MENU_HINT, formatModelChoices } from "../ui.js"; // status format + the SAME pure menu renderer the readline REPL uses
 import { renderMarkdown } from "../markdown.js"; // model speaks markdown → ANSI, same as the non-Ink REPL
 import { initFormState, reduceForm, renderForm, collectAnswers } from "../form.js"; // the ask_user form: pure state machine + renderer
 import { CONFIG, saveGlobalSetting } from "../config.js"; // session allowlist + /model save
 import { effortMenu, setEffort } from "../effort.js";
 import { useSlashCompletion } from "./completion.js";
+import { commandNames, commandTokenRanges, inlineCommandGhost } from "../completion.js"; // which /command tokens to paint + the mid-text ghost suggestion
 import { TerminateReason, listAgentViews } from "../loop.js"; // how a turn can end
 import { compactHistory, compactThreshold, contextWindowFor } from "../context.js"; // /compact + /model info
 import { forgetFilesExcept } from "../tools.js"; // /clear resets the file read-state
@@ -20,11 +21,13 @@ import { resetBoard } from "../board.js";
 import { clearReasoning, clearToolCalls, getReasoning, getToolCalls, getToolActivity, getToolCallCount, cleanup as tuiCleanup } from "../tui.js";
 import { expandMentions } from "../mentions.js"; // @file mentions → attach file contents
 import { normalizeDroppedPaths } from "../drop.js"; // drag-and-drop a file → its absolute path in the input
+import { currentSession, peerInboxPending, readPeerInbox, peerMessageContent, peersCommand, setSessionState, setSessionInfo, listPeers, findPeer, peerRow, sendPeerMessage, SCREEN_KINDS, MAX_PEER_TURNS } from "../peers.js"; // peer sessions: messages from other mini-agent windows start a turn while idle
 import { cronItemsPending, consumeCronQueue, cronTriggerContent } from "../cron.js"; // cron scheduler (Day s14): fire scheduled jobs autonomously while idle
 import { newSessionId, saveSession, listSessions, loadSession, setSessionTitle } from "../session.js";
-import { generateSessionTitle, setTerminalTitle } from "../title.js"; // concise session name, generated after the first message + the terminal tab that shows it
+import { generateSessionTitle, setTerminalTitle, refreshTerminalTitle, flashTerminalTitle } from "../title.js"; // concise session name, generated after the first message + the terminal tab that shows it
 import { isPlanMode, setPlanMode } from "../permissions.js";
-import { findSkill, userSkillMessages } from "../skills.js";
+import { findSkill, recordSkillUsage, skillSource, skillUsageScores, userSkillMessages } from "../skills.js";
+import { SkillsPanel } from "./skills-panel.js"; // /skills: Claude Code's on / user-only / off manager
 import { extractMemories } from "../memory.js";
 import { displayWidth } from "../editor.js"; // display-width measurement (CJK-aware)
 import { runHooks } from "../hooks.js";
@@ -45,7 +48,9 @@ const PLAN_MODE_NOTICE = `[plan mode ON] Investigate this request using only rea
 // it two cells wide — the text after the glyph then jumps on every other frame.
 const SPINNER_FRAMES = ["·", "✢", "✶", "✻", "✽", "✻", "✶", "✢"];
 const SPINNER_COLOR = "#D77757"; // Claude Code's orange
+const SKILL_COLOR = "#B1B9F9"; // Claude Code's lavender for a recognised /skill in the input
 const SHIMMER_PEAK = "#FFD2BD"; // the highlight that sweeps across the verb
+const COMPACT_PEAK = "#E4E8FF"; // the same sweep over the lavender "Compacting conversation…"
 const SHIMMER_TICK_MS = 100; // one animation clock for glyph + shimmer → one repaint per tick
 const SHIMMER_RADIUS = 3; // how many cells the highlight fades over on each side
 // Cap the live streaming preview to a terminal-aware tail. THIS IS LOAD-BEARING:
@@ -75,8 +80,8 @@ function useTick() {
 }
 // The glyph lives in a fixed two-cell box: whatever the frame, the text after it
 // starts in the same column.
-function Glyph({ tick }) {
-    return (_jsx(Box, { width: 2, flexShrink: 0, children: _jsx(Text, { color: SPINNER_COLOR, children: SPINNER_FRAMES[Math.floor(tick / 2) % SPINNER_FRAMES.length] }) }));
+function Glyph({ tick, color = SPINNER_COLOR }) {
+    return (_jsx(Box, { width: 2, flexShrink: 0, children: _jsx(Text, { color: color, children: SPINNER_FRAMES[Math.floor(tick / 2) % SPINNER_FRAMES.length] }) }));
 }
 function Spinner() {
     return _jsx(Glyph, { tick: useTick() });
@@ -89,10 +94,10 @@ function mix(a, b, t) {
 // The light sweep: each character is coloured by its distance from a moving
 // highlight. Only COLOUR changes between frames — never a character, never a
 // width — so the line shimmers without a single cell moving.
-export function shimmer(text, pos) {
+export function shimmer(text, pos, base = SPINNER_COLOR, peak = SHIMMER_PEAK) {
     return [...text].map((c, i) => {
         const glow = Math.max(0, 1 - Math.abs(i - pos) / SHIMMER_RADIUS);
-        return chalk.hex(mix(SPINNER_COLOR, SHIMMER_PEAK, glow))(c);
+        return chalk.hex(mix(base, peak, glow))(c);
     }).join("");
 }
 // "✶ Thinking… (3s · ↓ 281 tokens · thought for 1s)": the verb (everything up to
@@ -100,12 +105,14 @@ export function shimmer(text, pos) {
 // between sweeps (the highlight travels past the end) keeps it calm.
 function SpinnerLine({ text }) {
     const tick = useTick();
-    const plain = stripVTControlCharacters(text);
+    const [head, ...below] = text.split("\n"); // a status may carry extra lines (the compaction progress bar)
+    const plain = stripVTControlCharacters(head);
     const cut = plain.indexOf("…");
-    const verb = cut >= 0 && text.startsWith(plain.slice(0, cut + 1)) ? plain.slice(0, cut + 1) : ""; // shimmer only an unstyled verb
+    const verb = cut >= 0 && head.startsWith(plain.slice(0, cut + 1)) ? plain.slice(0, cut + 1) : ""; // shimmer only an unstyled verb
     const period = verb.length + SHIMMER_RADIUS * 2 + 8;
     const pos = (tick % period) - SHIMMER_RADIUS;
-    return (_jsxs(Box, { children: [_jsx(Glyph, { tick: tick }), _jsxs(Text, { color: SPINNER_COLOR, wrap: "truncate-end", children: [verb ? shimmer(verb, pos) : "", text.slice(verb.length)] })] }));
+    const [base, peak] = verb === COMPACTING_VERB ? [SKILL_COLOR, COMPACT_PEAK] : [SPINNER_COLOR, SHIMMER_PEAK]; // Claude Code draws compaction in lavender
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Glyph, { tick: tick, color: base }), _jsxs(Text, { color: base, wrap: "truncate-end", children: [verb ? shimmer(verb, pos, base, peak) : "", head.slice(verb.length)] })] }), below.map((line, i) => _jsxs(Text, { wrap: "truncate-end", children: ["  ", line] }, i))] }));
 }
 // One committed line of conversation. `user` is a highlight bar; `answer` is a
 // finished reply rendered as markdown; `note` is already-formatted narration.
@@ -163,7 +170,7 @@ const EXIT_NOTES = {
 };
 export function App({ session, runTurn, clipboard }) {
     const { rows, columns } = useTerminalSize();
-    const { client, messages, systemMessage, costMeter, skills: liveSkills, judge, autoMode, model, dir, branch, getStatus } = session;
+    const { client, messages, systemMessage, costMeter, skills: liveSkills, allSkills: everySkill, judge, autoMode, model, dir, branch, getStatus } = session;
     // Seed the scrollback with the welcome banner + the dim startup notices.
     const [items, setItems] = useState(() => [{ kind: "note", text: session.bannerText }, ...session.notices.map((n) => ({ kind: "note", text: chalk.dim(n) }))]);
     const [status, setStatus] = useState(null); // the live spinner line
@@ -171,6 +178,8 @@ export function App({ session, runTurn, clipboard }) {
     const [detailOffset, setDetailOffset] = useState(0);
     const [live, setLive] = useState(null); // the streaming answer
     const [input, setInput] = useState(""); // the current input buffer
+    const [talkTo, setTalkTo] = useState(null); // /peers → talk: the input box sends to another session instead of this agent
+    const replyTo = useRef([]); // who gets this turn's final answer (the senders of "user" peer messages)
     const [images, setImages] = useState([]);
     const pasting = useRef(false);
     const imageSeq = useRef(0);
@@ -210,9 +219,12 @@ export function App({ session, runTurn, clipboard }) {
         modelListEndpoint.current = CONFIG.baseURL;
         void client.models.list().then((page) => setCompletionModels(page.data.map((m) => m.id))).catch(() => { });
     }, [wantsModels, client]);
+    const typeaheadSkills = liveSkills().map((s) => ({ name: s.name, description: s.description, whenToUse: s.whenToUse, argNames: s.argNames, argumentHint: s.argumentHint, source: skillSource(s) }));
     const completion = useSlashCompletion(input, completing, {
-        model: CONFIG.model, skills: liveSkills(), models: completionModels, servers: listMcpServers().map((s) => s.name),
-    }, rows - 10);
+        model: CONFIG.model, skills: typeaheadSkills, models: completionModels, servers: listMcpServers().map((s) => s.name), usage: completing && input.startsWith("/") ? skillUsageScores() : undefined,
+    }, rows - 10, columns);
+    // A "/" later in the text: no list, just the rest of the best match as dim ghost text (Tab accepts).
+    const ghost = completing && cursor === input.length ? inlineCommandGhost(input, { skills: typeaheadSkills }) : null;
     useEffect(() => {
         const id = setInterval(() => setTick((t) => t + 1), 1000);
         return () => clearInterval(id);
@@ -239,7 +251,10 @@ export function App({ session, runTurn, clipboard }) {
             pushItem(display);
         clearReasoning(); // Ctrl+R should reveal THIS turn's thinking
         clearToolCalls(); // ...and Ctrl+T THIS turn's tool calls
+        const senders = replyTo.current; // taken now, so a failed turn can't leak them into the next one
+        replyTo.current = [];
         setBusy(true);
+        setSessionState("busy", CONFIG.model); // other sessions see "busy" in list_peers
         const controller = new AbortController();
         const tstate = { controller, interrupted: false };
         turn.current = tstate; // expose it so Esc can interrupt this turn
@@ -273,6 +288,9 @@ export function App({ session, runTurn, clipboard }) {
         };
         runTurn(content, hooks)
             .then(async (result) => {
+            // A turn started by the user from another window: show them the answer there.
+            for (const to of senders)
+                sendPeerMessage(to, result.finalText?.trim() || `(finished: ${result.reason})`, "reply");
             if (result.reason !== TerminateReason.Done && !(result.reason === TerminateReason.UserInterrupt && followUps.size))
                 note(chalk.yellow(`⚠️ ${EXIT_NOTES[result.reason] ?? result.reason}`));
             saveSession(sessionId, model, messages, pendingTitle.current); // snapshot after every turn — crash-safe by construction
@@ -290,6 +308,7 @@ export function App({ session, runTurn, clipboard }) {
             .catch((e) => note(chalk.red(`[error] ${e.message}`)))
             .finally(() => {
             turn.current = null;
+            setSessionState("idle");
             setBusy(false);
             setStatus(null);
             setLive(null);
@@ -324,13 +343,131 @@ export function App({ session, runTurn, clipboard }) {
         return () => clearInterval(id);
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [busy, pending]);
+    // The PEER idle processor: another mini-agent session messaged this one while
+    // it sat at the prompt. Like cron, start a turn so the agent answers on its
+    // own. Two agents answering each other could run forever (and bill for every
+    // hop), so after MAX_PEER_TURNS auto-started turns with no human input in
+    // between, messages wait in the inbox until you type something.
+    const peerTurns = useRef(0);
+    const peerHoldNoted = useRef(false);
+    useEffect(() => {
+        if (busy || pending || followUps.size)
+            return; // human follow-ups take priority
+        const id = setInterval(() => {
+            const waiting = peerInboxPending();
+            if (!waiting || turn.current)
+                return;
+            const fromUser = peerInboxPending(["user"]);
+            if (fromUser) {
+                // You, typing in another window: never held by the agent-to-agent cap.
+                const got = readPeerInbox(["user"]);
+                peerTurns.current = 0;
+                peerHoldNoted.current = false;
+                replyTo.current = [...new Set(got.map((m) => m.from.id))];
+                runConversationTurn(peerMessageContent(got), { kind: "user", text: `${got.map((m) => m.text).join("\n")}   ${chalk.magenta(`(from your "${got[0].from.name}" window)`)}` });
+                return;
+            }
+            if (peerTurns.current >= MAX_PEER_TURNS) {
+                if (!peerHoldNoted.current)
+                    note(chalk.yellow(`✉ ${waiting} peer message${waiting > 1 ? "s" : ""} waiting — paused after ${MAX_PEER_TURNS} automatic turns in a row; send anything to continue`));
+                peerHoldNoted.current = true;
+                return;
+            }
+            const got = readPeerInbox();
+            if (!got.length)
+                return;
+            peerTurns.current++;
+            const from = [...new Set(got.map((m) => `${m.from.name} (${m.from.cwd})`))].join(", ");
+            runConversationTurn(peerMessageContent(got), { kind: "note", text: chalk.magenta(`✉ message from ${from}`) });
+        }, 1000);
+        return () => clearInterval(id);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [busy, pending]);
+    // Replies and "which window are you?" pings are for the SCREEN, not the model:
+    // handled even mid-turn, never starting a model call.
+    useEffect(() => {
+        const id = setInterval(() => {
+            if (!peerInboxPending(SCREEN_KINDS))
+                return;
+            for (const m of readPeerInbox(SCREEN_KINDS)) {
+                if (m.kind === "identify") {
+                    flashTerminalTitle();
+                    note(chalk.bgMagenta.white.bold(` 👋 This window is session "${m.text}" — the "${m.from.name}" window is looking for it `));
+                }
+                else {
+                    note(chalk.magenta(`↩ ${m.from.name} replied:`));
+                    pushItem({ kind: "answer", text: m.text });
+                }
+            }
+        }, 1000);
+        return () => clearInterval(id);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    // /peers: pick another session, then talk to it (the input box addresses it)
+    // or make it identify itself (bell + flashing tab) so you know which window it is.
+    const openPeers = () => {
+        const peers = listPeers();
+        if (!peers.length)
+            return note(chalk.dim(peersCommand("/peers")));
+        openSelect(`Other mini-agent sessions — pick one · this one is "${currentSession()?.name ?? "?"}" (/rename <name> to change)`, [...peers.map(peerRow), "Cancel"], (i) => {
+            const p = peers[i];
+            if (!p)
+                return;
+            openSelect(`${p.name} · ${p.terminal}`, [`Talk to ${p.name} — type in this box, Esc to come back`, "Identify it — ring its bell and flash its tab title", "Cancel"], (j) => {
+                if (j === 0) {
+                    setTalkTo(p);
+                    note(chalk.magenta(`→ talking to "${p.name}" (${p.terminal}). What you type goes there; its answer comes back here. Esc returns to this agent.`));
+                }
+                else if (j === 1) {
+                    const sent = sendPeerMessage(p.id, p.name, "identify");
+                    note(sent.startsWith("[error]") ? chalk.yellow(sent) : chalk.dim(`(asked "${p.name}" to flash its tab — look for 👋 ${p.name} — HERE)`));
+                }
+            }, peerRow(p));
+        });
+    };
     // A normal (non-command) prompt: run UserPromptSubmit hooks, expand @file
     // mentions, then start the turn. Mirrors agent.ts's submit path.
     const submitLine = async (draft, attachments = [], immediate = false) => {
+        peerTurns.current = 0; // a human is here: peers may start turns again
+        peerHoldNoted.current = false;
+        // Talk mode: plain text goes to the chosen session, even while this agent works.
+        if (talkTo && !pending && !draft.startsWith("/")) {
+            const text = pastedTexts.expand(draft);
+            const alive = findPeer(talkTo.id);
+            if (!alive) {
+                setTalkTo(null);
+                return note(chalk.yellow(`"${talkTo.name}" is no longer running — back to this agent`));
+            }
+            const sent = sendPeerMessage(alive.id, text, "user");
+            if (sent.startsWith("[error]"))
+                return note(chalk.yellow(sent));
+            pushItem({ kind: "user", text: `→ ${alive.name}: ${draft}` });
+            if (alive.state === "busy")
+                note(chalk.dim(`("${alive.name}" is busy — it answers when its current turn ends)`));
+            return;
+        }
+        if (!draft.startsWith("/"))
+            setSessionInfo({ lastPrompt: draft });
         if (!pending && turn.current && (draft.startsWith("/") || draft === "exit" || draft === "quit")) {
             note(chalk.dim("Commands are available when the agent is idle; use Esc to interrupt."));
             return;
         }
+        // A /command typed while a menu is up is a command, never a message for the
+        // model (a second "/peers" into the /peers picker used to become the
+        // conversation's first prompt). Close the menu, then run it — when idle.
+        if (pending && /^\/[\w:-]+(\s|$)/.test(draft)) {
+            if (turn.current)
+                return note(chalk.dim("Commands are available when the agent is idle; use Esc to interrupt."));
+            setPending(null);
+            setFormState(null);
+            if (pending.kind === "form")
+                pending.resolve(null);
+            else if (pending.kind === "select")
+                pending.onChoose(-1);
+            if (await handleCommand(draft))
+                return;
+            return note(chalk.dim(`unknown command: ${draft} — try /help`));
+        }
         if (!pending && (draft === "exit" || draft === "quit"))
             return doExit();
         if (!pending && await handleCommand(draft))
@@ -375,7 +512,7 @@ export function App({ session, runTurn, clipboard }) {
                 setFormState(null);
                 if (pending.kind === "form")
                     pending.resolve(null);
-                else
+                else if (pending.kind === "select")
                     pending.onChoose(-1);
             }
             if (immediate)
@@ -466,6 +603,11 @@ export function App({ session, runTurn, clipboard }) {
         }
         if (line.startsWith("/skills "))
             line = `/skill ${line.slice(8).trim()}`;
+        if (line === "/skills") {
+            setDetails(null);
+            setPending({ kind: "skills" });
+            return true;
+        } // Claude Code's manager: on / user-only / off per skill
         if (line === "/effort" || line.startsWith("/effort ")) {
             const target = CONFIG.model;
             const value = line.slice("/effort".length).trim();
@@ -491,6 +633,16 @@ export function App({ session, runTurn, clipboard }) {
             setAutoEnabled(autoMode.enabled);
             return true;
         }
+        if (line === "/peers") {
+            openPeers();
+            return true;
+        }
+        const peers = peersCommand(line); // /rename <name>
+        if (peers !== null) {
+            note(chalk.dim(peers));
+            refreshTerminalTitle();
+            return true;
+        }
         const info = runInfoCommand(line, { skills: liveSkills(), costMeter }); // /help /cost /memory /stats /todos /bg /team /tasks /skills /undo /diff
         if (info !== null) {
             note(info);
@@ -557,6 +709,7 @@ export function App({ session, runTurn, clipboard }) {
                 return true;
             }
             autoMode.recordRequest(`/${s.name}${args ? ` ${args}` : ""}`);
+            recordSkillUsage(s.name); // feeds the "/" typeahead's most-used ranking
             runConversationTurn(userSkillMessages(s, args), { kind: "note", text: chalk.dim(`(running skill: ${s.name})`) });
             return true;
         }
@@ -598,7 +751,7 @@ export function App({ session, runTurn, clipboard }) {
                 }
                 setBusy(true);
                 try {
-                    await compactHistory(messages, client, CONFIG.model, new AbortController().signal, note);
+                    await compactHistory(messages, client, CONFIG.model, new AbortController().signal, note, sink); // the same progress bar as automatic compaction
                 }
                 catch (err) {
                     note(chalk.yellow(`compaction failed: ${err.message}`));
@@ -664,6 +817,8 @@ export function App({ session, runTurn, clipboard }) {
             tuiCleanup();
             return exit(); // Ctrl+C quits immediately (process.on exit cleans up MCP/background)
         }
+        if (pending?.kind === "skills")
+            return; // the /skills panel owns the keyboard while it is open
         const modifiedReturn = char === "[13;5u" || char === "[27;5;13~";
         // A submitted follow-up may still be passing hooks. A second Enter must
         // not approve the old action while that asynchronous preparation runs.
@@ -733,6 +888,11 @@ export function App({ session, runTurn, clipboard }) {
             statusRequest.current.abort();
             return;
         }
+        if (key.escape && talkTo && !pending && !input) {
+            setTalkTo(null);
+            note(chalk.dim(`(back to this agent — no longer talking to "${talkTo.name}")`));
+            return;
+        }
         if (key.escape && busy && !pending) {
             if (followUps.size) {
                 interruptForFollowUp();
@@ -792,6 +952,13 @@ export function App({ session, runTurn, clipboard }) {
                 return;
             }
         }
+        if (key.tab && ghost) { // accept the inline suggestion as "/name "
+            const next = input.slice(0, ghost.start) + `/${ghost.full} `;
+            setInput(next);
+            setCursor(next.length);
+            setHistIdx(null);
+            return;
+        }
         const completionAction = completion.handleKey(key, (value) => { setInput(value); setCursor(value.length); setHistIdx(null); });
         if (completionAction.handled && !completionAction.submit)
             return;
@@ -932,15 +1099,16 @@ export function App({ session, runTurn, clipboard }) {
     const agentDetailView = detailPage(selectedAgent?.transcript || "(Waiting for activity…)", agentPage, Math.max(1, Math.min(10, rows - 10)), Math.max(1, columns - 4));
     const detailView = detailPage(details === "tools" ? getToolCalls() ?? "No tool calls this turn." : details === "reasoning" ? getReasoning() ?? "No thinking recorded this turn." : "", detailOffset, Math.max(1, Math.min(12, rows - 9)), Math.max(1, columns - 4));
     const activity = rows >= 20 && busy && !details && !pending && !subAgentDetail && !followUps.size ? summarizeActivity(getToolActivity(), Date.now(), rows >= 30 && !agents.length ? 2 : 1) : [];
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: items, children: (item, i) => _jsx(ItemView, { item: item }, i) }), _jsxs(Box, { flexDirection: "column", height: !pending && (details || selectedAgent) ? Math.max(1, rows - 1) : undefined, overflow: "hidden", children: [live !== null && !details && !pending && !selectedAgent && (_jsxs(Box, { marginTop: rows >= 20 ? 1 : 0, flexDirection: "row", children: [_jsx(Text, { color: "green", children: "\u23FA " }), _jsx(Box, { flexGrow: 1, children: _jsx(Text, { children: live === "" ? chalk.dim("…") : liveTail(live, rows, columns, followUps.size > 0) }) })] })), activity.map((group, i) => (_jsxs(Box, { flexDirection: "column", marginTop: i === 0 ? 1 : 0, children: [_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: group.failed ? "yellow" : group.running ? "cyan" : "green", children: "\u25CF " }), _jsx(Text, { bold: true, children: group.title })] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  \u23BF ", group.detail] })] }, i))), !details && !pending && !selectedAgent && (status !== null || busy) && (_jsx(Box, { marginTop: rows >= 20 ? 1 : 0, children: _jsx(SpinnerLine, { text: status?.replace("Ctrl+C to interrupt", "Esc to interrupt") ?? (live !== null ? "Writing…" : "Working…") }) })), rows >= 20 && !details && !selectedAgent && !pending && (busy || getToolCallCount() > 0) && (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  ", getToolCallCount(), " tool calls \u00B7 Ctrl+T details \u00B7 Ctrl+R thinking", busy ? " · Esc interrupt" : ""] })), details && !pending && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [details === "tools" ? "Tool details" : "Thinking", " \u00B7 ", detailView.pages - detailView.page, "/", detailView.pages, " \u00B7 \u2191\u2193 page \u00B7 Esc close", followUps.size ? ` · ${followUps.size} queued` : ""] }), _jsx(Text, { children: detailView.text })] })), selectedAgent && !pending && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "blue", paddingX: 1, children: [_jsxs(Text, { bold: true, color: "cyan", wrap: "truncate-end", children: [selectedAgent.name, " \u00B7 ", selectedAgent.model, " \u00B7 ", selectedAgent.status, " \u00B7 Esc main"] }), _jsxs(Box, { children: [selectedAgent.status === "running" && _jsx(Spinner, {}), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [" ", selectedAgent.activity, " \u00B7 ", selectedAgent.toolCalls, " tools \u00B7 PgUp/PgDn details"] })] }), _jsx(Text, { children: agentDetailView.text })] })), pending?.kind === "select" && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", children: pending.header }), pending.body && _jsx(Box, { marginY: 1, children: _jsx(Text, { children: pending.body }) }), _jsx(Text, { children: renderMenu(pending.options, menuSel) }), _jsx(Text, { children: MENU_HINT })] })), pending?.kind === "form" && formState && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: renderForm(pending.questions, formState) }) })), pending && _jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Type a follow-up \u00B7 Enter sends text; empty input selects \u00B7 Esc cancels" }), !details && !selectedAgent && !pending && followUps.size > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: rows >= 20 ? 1 : 0, children: [_jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Messages queued for the next tool boundary \u00B7 Esc / Ctrl+Enter interrupt and send" }), followUps.pending.slice(rows >= 20 ? -2 : -1).map((message, i) => _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  \u21B3 ", message.displayText ?? message.text] }, i)), followUps.size > 2 && _jsxs(Text, { dimColor: true, children: ["  \u2026 ", followUps.size - 2, " earlier messages queued"] })] })), _jsx(Box, { borderStyle: "round", borderColor: planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : autoEnabled ? "yellow" : "cyan", paddingX: 1, marginTop: rows >= 20 ? 1 : 0, flexDirection: "column", flexShrink: 0, children: (() => {
-                            const prompt = "❯ ";
-                            const promptColor = planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : autoEnabled ? "yellow" : "cyan";
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: items, children: (item, i) => _jsx(ItemView, { item: item }, i) }), _jsxs(Box, { flexDirection: "column", height: !pending && (details || selectedAgent) ? Math.max(1, rows - 1) : undefined, overflow: "hidden", children: [live !== null && !details && !pending && !selectedAgent && (_jsxs(Box, { marginTop: rows >= 20 ? 1 : 0, flexDirection: "row", children: [_jsx(Text, { color: "green", children: "\u23FA " }), _jsx(Box, { flexGrow: 1, children: _jsx(Text, { children: live === "" ? chalk.dim("…") : liveTail(live, rows, columns, followUps.size > 0) }) })] })), activity.map((group, i) => (_jsxs(Box, { flexDirection: "column", marginTop: i === 0 ? 1 : 0, children: [_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: group.failed ? "yellow" : group.running ? "cyan" : "green", children: "\u25CF " }), _jsx(Text, { bold: true, children: group.title })] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  \u23BF ", group.detail] })] }, i))), !details && !pending && !selectedAgent && (status !== null || busy) && (_jsx(Box, { marginTop: rows >= 20 ? 1 : 0, children: _jsx(SpinnerLine, { text: status?.replace("Ctrl+C to interrupt", "Esc to interrupt") ?? (live !== null ? "Writing…" : "Working…") }) })), rows >= 20 && !details && !selectedAgent && !pending && (busy || getToolCallCount() > 0) && (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  ", getToolCallCount(), " tool calls \u00B7 Ctrl+T details \u00B7 Ctrl+R thinking", busy ? " · Esc interrupt" : ""] })), details && !pending && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [details === "tools" ? "Tool details" : "Thinking", " \u00B7 ", detailView.pages - detailView.page, "/", detailView.pages, " \u00B7 \u2191\u2193 page \u00B7 Esc close", followUps.size ? ` · ${followUps.size} queued` : ""] }), _jsx(Text, { children: detailView.text })] })), selectedAgent && !pending && (_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "blue", paddingX: 1, children: [_jsxs(Text, { bold: true, color: "cyan", wrap: "truncate-end", children: [selectedAgent.name, " \u00B7 ", selectedAgent.model, " \u00B7 ", selectedAgent.status, " \u00B7 Esc main"] }), _jsxs(Box, { children: [selectedAgent.status === "running" && _jsx(Spinner, {}), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [" ", selectedAgent.activity, " \u00B7 ", selectedAgent.toolCalls, " tools \u00B7 PgUp/PgDn details"] })] }), _jsx(Text, { children: agentDetailView.text })] })), pending?.kind === "select" && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", children: pending.header }), pending.body && _jsx(Box, { marginY: 1, children: _jsx(Text, { children: pending.body }) }), _jsx(Text, { children: renderMenu(pending.options, menuSel) }), _jsx(Text, { children: MENU_HINT })] })), pending?.kind === "skills" && (_jsx(SkillsPanel, { skills: everySkill(), maxRows: Math.max(3, rows - 14), onClose: (summary) => { setPending(null); note(chalk.dim(summary)); } })), pending?.kind === "form" && formState && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: renderForm(pending.questions, formState) }) })), pending && pending.kind !== "skills" && _jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Type a follow-up \u00B7 Enter sends text; empty input selects \u00B7 Esc cancels" }), !details && !selectedAgent && !pending && followUps.size > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: rows >= 20 ? 1 : 0, children: [_jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Messages queued for the next tool boundary \u00B7 Esc / Ctrl+Enter interrupt and send" }), followUps.pending.slice(rows >= 20 ? -2 : -1).map((message, i) => _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["  \u21B3 ", message.displayText ?? message.text] }, i)), followUps.size > 2 && _jsxs(Text, { dimColor: true, children: ["  \u2026 ", followUps.size - 2, " earlier messages queued"] })] })), pending?.kind !== "skills" && (_jsx(Box, { borderStyle: "round", borderColor: talkTo || planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : autoEnabled ? "yellow" : "cyan", paddingX: 1, marginTop: rows >= 20 ? 1 : 0, flexDirection: "column", flexShrink: 0, children: (() => {
+                            const prompt = talkTo ? `→ ${talkTo.name} ❯ ` : "❯ ";
+                            const promptColor = talkTo ? "magenta" : planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : autoEnabled ? "yellow" : "cyan";
                             const cols = columns;
                             const innerWidth = Math.max(10, cols - 4); // border(2) + paddingX(2)
                             const promptW = displayWidth(prompt);
                             const firstW = Math.max(1, innerWidth - promptW);
                             // Build visual lines display-width-aware (CJK, emoji = 2 cols).
                             const lines = [""];
+                            const lineStarts = [0]; // code-unit offset where each visual line begins (for skill highlighting)
                             let row = 0;
                             let col = 0;
                             // Cursor tracking: map code-unit offset → (line, display-column).
@@ -960,6 +1128,7 @@ export function App({ session, runTurn, clipboard }) {
                                     row++;
                                     col = 0;
                                     lines[row] = "";
+                                    lineStarts[row] = cu;
                                 }
                                 lines[row] += ch;
                                 col += cw;
@@ -974,9 +1143,35 @@ export function App({ session, runTurn, clipboard }) {
                             if (cursorCol >= edge) {
                                 cursorLine++;
                                 cursorCol = 0;
-                                if (lines.length <= cursorLine)
+                                if (lines.length <= cursorLine) {
                                     lines.push("");
+                                    lineStarts.push(cu);
+                                }
                             }
+                            // "/<skill>" tokens anywhere in the draft are painted — the typeahead
+                            // only opens at the start, but a real skill name lights up wherever
+                            // it is. paint() splits a slice of a line into plain and lit runs.
+                            const lit = commandTokenRanges(input, commandNames({ skills: liveSkills() }));
+                            const isLit = (at) => lit.some(([a, b]) => at >= a && at < b);
+                            const paint = (text, from, keyBase) => {
+                                const runs = [];
+                                let run = "";
+                                let runLit = false;
+                                let at = from;
+                                const flush = () => { if (run)
+                                    runs.push(_jsx(Text, { color: runLit ? SKILL_COLOR : undefined, children: run }, `${keyBase}${runs.length}`)); run = ""; };
+                                for (const ch of text) {
+                                    const l = isLit(at);
+                                    if (l !== runLit) {
+                                        flush();
+                                        runLit = l;
+                                    }
+                                    run += ch;
+                                    at += ch.length;
+                                }
+                                flush();
+                                return runs;
+                            };
                             // Map display-column back to code-unit offset within the target line.
                             const cursorLineText = lines[cursorLine] ?? "";
                             let cuOff = 0; // code-unit offset into cursorLineText that matches cursorCol
@@ -997,9 +1192,10 @@ export function App({ session, runTurn, clipboard }) {
                                     const before = line.slice(0, cuOff);
                                     const at = line.slice(cuOff, cuOff + 1) || " ";
                                     const after = line.slice(cuOff + 1);
-                                    return (_jsxs(Box, { children: [i === 0 && _jsx(Text, { color: promptColor, children: prompt }), _jsx(Text, { children: before }), _jsx(Text, { inverse: true, children: at }), _jsx(Text, { children: after })] }, i));
+                                    const base = lineStarts[i] ?? 0;
+                                    return (_jsxs(Box, { children: [i === 0 && _jsx(Text, { color: promptColor, children: prompt }), _jsx(Text, { children: paint(before, base, "b") }), _jsx(Text, { inverse: true, color: isLit(base + cuOff) ? SKILL_COLOR : undefined, children: ghost ? ghost.suffix[0] : at }), _jsx(Text, { children: paint(after, base + cuOff + at.length, "a") }), ghost && _jsx(Text, { dimColor: true, children: ghost.suffix.slice(1) })] }, i));
                                 }
-                                return (_jsxs(Box, { children: [i === 0 && _jsx(Text, { color: promptColor, children: prompt }), _jsx(Text, { children: line })] }, i));
+                                return (_jsxs(Box, { children: [i === 0 && _jsx(Text, { color: promptColor, children: prompt }), _jsx(Text, { children: paint(line, lineStarts[i] ?? 0, "l") })] }, i));
                             });
-                        })() }), completion.view, rows >= 20 && busy && !details && !selectedAgent && !pending && _jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Enter queue follow-up \u00B7 Ctrl+Enter interrupt and send now" }), rows >= 20 && !details && !selectedAgent && !pending && !completion.visible && _jsx(AgentList, { agents: agents, focus: subAgentFocus, viewing: subAgentDetail, mainBusy: busy, maxRows: Math.max(2, Math.min(3, rows - 24)) }), _jsxs(Box, { justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 1, children: _jsx(StatusBar, { model: CONFIG.model, dir: dir, branch: branch, status: getStatus() }) }), _jsx(McpBadge, {})] }), (planMode || autoEnabled || CONFIG.bypassPermissions) && (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : "yellow", children: planMode ? "⏸ plan mode on" : CONFIG.bypassPermissions ? "▶▶ bypass permissions on" : "▶▶ auto mode on" }), _jsx(Text, { dimColor: true, children: planMode ? " (/plan to toggle)" : CONFIG.bypassPermissions ? " (this run)" : " (/auto to toggle)" })] }))] })] }));
+                        })() })), completion.view, rows >= 20 && busy && !details && !selectedAgent && !pending && _jsx(Text, { dimColor: true, wrap: "truncate-end", children: "Enter queue follow-up \u00B7 Ctrl+Enter interrupt and send now" }), rows >= 20 && !details && !selectedAgent && !pending && !completion.visible && _jsx(AgentList, { agents: agents, focus: subAgentFocus, viewing: subAgentDetail, mainBusy: busy, maxRows: Math.max(2, Math.min(3, rows - 24)) }), _jsxs(Box, { justifyContent: "space-between", children: [_jsx(Box, { flexShrink: 1, children: _jsx(StatusBar, { model: CONFIG.model, dir: dir, branch: branch, status: getStatus() }) }), _jsx(McpBadge, {})] }), (planMode || autoEnabled || CONFIG.bypassPermissions) && (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: planMode ? "magenta" : CONFIG.bypassPermissions ? "red" : "yellow", children: planMode ? "⏸ plan mode on" : CONFIG.bypassPermissions ? "▶▶ bypass permissions on" : "▶▶ auto mode on" }), _jsx(Text, { dimColor: true, children: planMode ? " (/plan to toggle)" : CONFIG.bypassPermissions ? " (this run)" : " (/auto to toggle)" })] }))] })] }));
 }

package/dist/ink/commands.js

@@ -36,10 +36,12 @@ export const SESSION_HELP = `commands:
   /team      list the agent team (spawn_teammate): each teammate's role, status, and pending inbox
   /tasks     show the shared task board (create_task/claim_task): each task's status, owner, and dependencies
   /cron      list scheduled cron jobs (schedule_cron) and their expressions
+  /peers     pick another mini-agent session on this machine: talk to it from this box (Esc to come back), or make it flash its tab so you know which window it is
+  /rename <name>  rename this session — the name other sessions use to reach it
   /undo      revert the most recent file write (write_file / edit_file) this session
   /diff      show every file changed this session, as a diff from where it started
   /resume    list recent sessions in this project and continue one of them
-  /skills    list the reusable skills available in this project
+  /skills    manage skills: turn each on, off, or user-only (search with /, sort with t)
   /skill <name> [args]  run a skill yourself (works even for user-only skills); /<name> [args] works too
   exit       leave (Ctrl+C does the same)
 

package/dist/ink/completion.js

@@ -1,18 +1,19 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { Box, Text } from "ink";
 import { slashCompletions } from "../completion.js";
 // Keep the full list in state, but render only a window around the selection.
 // Long lists must never grow Ink's redraw region beyond the terminal height.
-export function useSlashCompletion(input, enabled, context, maxRows) {
+export function useSlashCompletion(input, enabled, context, maxRows, columns = 80) {
     const [selection, setSelection] = useState({ input: "", index: 0 });
     const [dismissed, setDismissed] = useState(null);
     useEffect(() => { setDismissed(null); }, [input]);
     const menu = enabled && dismissed !== input ? slashCompletions(input, context) : null;
     const items = menu?.items ?? [];
     const selected = Math.min(selection.input === input ? selection.index : 0, Math.max(0, items.length - 1));
-    const count = Math.max(1, Math.min(8, maxRows));
+    const count = Math.max(1, Math.min(6, maxRows)); // Claude Code shows at most 6, centred on the selection
     const start = Math.max(0, Math.min(selected - Math.floor(count / 2), items.length - count));
+    const nameWidth = Math.min(Math.max(0, ...items.map((item) => item.value.length)) + 2, Math.floor(columns * 0.4));
     return {
         visible: menu !== null,
         handleKey: (key, replace) => {
@@ -30,14 +31,21 @@ export function useSlashCompletion(input, enabled, context, maxRows) {
             }
             if (key.tab || (key.return && !key.ctrl && !key.meta)) {
                 const item = items[selected];
+                // Tab always just fills it in. Enter runs it — unless it takes
+                // arguments (a skill with `arguments`, or a command with sub-choices),
+                // then it fills "/name " so you can type them. (Claude Code's rule.)
                 if (key.tab || item.children)
-                    replace(item.value + (item.children ? " " : ""));
+                    replace(item.value + " ");
                 else
                     return { handled: true, submit: item.value };
                 return { handled: true };
             }
             return { handled: false };
         },
-        view: menu && (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [items.slice(start, start + count).map((item, i) => (_jsxs(Text, { color: start + i === selected ? "cyan" : undefined, bold: start + i === selected, wrap: "truncate-end", children: [start + i === selected ? "› " : "  ", item.value, "  ", _jsx(Text, { dimColor: true, children: item.description.replace(/\s+/g, " ") })] }, item.value))), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: items.length ? `↑↓ choose · Tab complete · Enter select · Esc close · ${selected + 1}/${items.length}` : menu.hint || "No matching commands" })] })),
+        view: menu && (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [items.slice(start, start + count).map((item, i) => {
+                    const on = start + i === selected;
+                    // Names in one column (at most 40% of the width); the description is one line, cut to fit.
+                    return (_jsxs(Text, { color: on ? "#B1B9F9" : undefined, dimColor: !on, wrap: "truncate-end", children: [on ? "› " : "  ", item.value.padEnd(nameWidth), item.description.replace(/\s+/g, " ")] }, item.value));
+                }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: items.length ? `↑↓ choose · Tab complete · Enter select · Esc close · ${selected + 1}/${items.length}` : menu.hint || "No matching commands" })] })),
     };
 }

package/dist/ink/launch.js

@@ -12,4 +12,9 @@ export async function launchInk(opts = {}) {
     const session = await buildInkSession({ resume: opts.resume });
     const { waitUntilExit } = render(_jsx(App, { session: session, runTurn: makeRunTurn(session.client, session.messages) }));
     await waitUntilExit(); // keep the process alive until the user quits
+    // Then leave for real. The cron poll, the settings watcher and friends keep
+    // the event loop busy, so without this the process lingers after the UI is
+    // gone — and the process.on("exit") cleanups (MCP servers, background jobs,
+    // this session's peer record) never run.
+    process.exit(0);
 }

package/dist/ink/setup.js

@@ -6,6 +6,7 @@ import { buildSystemMessage, readProjectInstructions } from "../prompt.js";
 import { contextPercent } from "../context.js";
 import { initCostMeter, DEFAULT_PRICING } from "../cost.js";
 import { gitBranch } from "../tui.js";
+import { listPeers, registerSession, unregisterSession } from "../peers.js"; // peer sessions: other mini-agent processes on this machine
 import { newSessionId, latestSession } from "../session.js";
 import { initTelemetry, emit } from "../telemetry.js";
 import { runHooks } from "../hooks.js";
@@ -14,7 +15,7 @@ import { Judge } from "../judge.js";
 import { AutoMode } from "../auto.js";
 import { registerExternalTool } from "../tools.js";
 import { rememberTool, readMemory } from "../memory.js";
-import { currentSkills } from "../skills.js";
+import { allSkills, currentSkills } from "../skills.js";
 import { killAllBackground } from "../background.js";
 import { killAllSubAgents } from "../loop.js";
 import { loadDurableJobs, startCronScheduler, stopCronScheduler, listJobs } from "../cron.js"; // cron scheduler (Day s14)
@@ -93,6 +94,13 @@ export async function buildInkSession(opts = {}) {
         messages.push({ role: "user", content: `[SessionStart hook]\n${sessionStart.stdout}` });
     const dir = path.basename(process.cwd());
     const branch = gitBranch();
+    // Peer sessions: join the machine-wide registry so other mini-agent windows
+    // can find and message this one (and this one them).
+    const me = registerSession({ cwd: process.cwd(), branch, model: CONFIG.model });
+    process.on("exit", unregisterSession);
+    const others = listPeers().length;
+    if (others)
+        notices.push(`(peers: this session is "${me.name}"; ${others} other session${others === 1 ? "" : "s"} online — /peers)`);
     const getStatus = () => ({
         ctxPct: contextPercent(messages), // % of the way to auto-compaction
         cost: costMeter.cost(),
@@ -107,6 +115,7 @@ export async function buildInkSession(opts = {}) {
         startedAt,
         costMeter,
         skills: () => currentSkills(),
+        allSkills: () => allSkills(),
         judge,
         autoMode,
         model: CONFIG.model,