@matterailab/orbcode 0.3.2 → 0.3.4

package/README.md

@@ -297,7 +297,8 @@ MatterAI gateway untouched.
 | `/tasks`     | print the current task list                                                                           |
 | `/status`    | version, model, account, gateway, context usage, cost, approval modes                                 |
 | `/usage`     | fetch plan usage                                                                                      |
-| `/init`      | analyze the codebase and create/improve `AGENTS.md`                                                   |
+| `/init`      | analyze the codebase and create/improve `AGENTS.md` in the repo's `.orb/` directory                   |
+| `/link`      | link other repos on your machine so changes here are checked against them (enter a folder path) |
 | `/mcp`       | manage MCP servers — enable, disable, reconnect, view status & tool counts                            |
 | `/login`     | start the browser sign-in flow                                                                        |
 | `/logout`    | remove the saved token                                                                                |

package/dist/branding.js

@@ -23,9 +23,9 @@ export const COLORS = {
     user: "#569CD6",
 };
 export const LOGO = `
-  ___         _       ____             _
- / _ \\  _ __ | |__   / ___|  ___    __| |  ___
-| | | || '__|| '_ \\ | |     / _ \\  / _\` | / _ \\
-| |_| || |   | |_) || |___ | (_) || (_| ||  __/
- \\___/ |_|   |_.__/  \\____| \\___/  \\__,_| \\___|
+  ___       _                   _
+ / _ \\ _ __| |__   ___ ___   __| | ___
+| | | | '__| '_ \\ / __/ _ \\ / _\` |/ _ \\
+| |_| | |  | |_) | (_| (_) | (_| |  __/
+ \\___/|_|  |_.__/ \\___\\___/ \\__,_|\\___|
 `;

package/dist/config/links.js

@@ -0,0 +1,163 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+const MAX_AGENTS_CHARS = 4000;
+const MAX_LINKED_REPOS = 8;
+/** Where a linked repo's AGENTS.md might live, in precedence order. `.orbital`
+ *  (the IDE extension's dir) and `.orbcode` are legacy locations, still read for
+ *  backward compatibility and cross-tool linking. */
+const AGENTS_LOCATIONS = [
+    path.join(".orb", "AGENTS.md"),
+    path.join(".orbital", "AGENTS.md"),
+    path.join(".orbcode", "AGENTS.md"),
+    "AGENTS.md",
+];
+function isDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The repo-level OrbCode directory for shared, tool-neutral data like AGENTS.md
+ * and links.json — always `.orb`. This is the folder the IDE and the CLI both
+ * read/write, so they stay in sync.
+ *
+ * Note: this is deliberately NOT where machine settings live. Those stay put
+ * (`~/.orbcode` and `<repo>/.orbcode/settings.json`); only the repo-level
+ * AGENTS.md/links folder moved to `.orb`. Legacy `.orbcode/AGENTS.md` files are
+ * still *read* (see the memory loader and AGENTS_LOCATIONS), but new files are
+ * written here.
+ */
+export function resolveProjectDir(cwd) {
+    return path.join(cwd, ".orb");
+}
+function linksFilePath(cwd) {
+    return path.join(resolveProjectDir(cwd), "links.json");
+}
+/**
+ * Read the linked repos for a project (empty array if none / unreadable).
+ *
+ * The schema is tolerant so links written by either tool work: each entry needs
+ * only an `input` (the IDE extension may omit the resolved `path`); we fill the
+ * `path` by resolving the input when it's missing.
+ */
+export function loadLinks(cwd = process.cwd()) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(linksFilePath(cwd), "utf8"));
+        if (!Array.isArray(parsed.links))
+            return [];
+        const out = [];
+        for (const raw of parsed.links) {
+            if (!raw)
+                continue;
+            const input = typeof raw.input === "string" ? raw.input : typeof raw.path === "string" ? raw.path : undefined;
+            if (!input)
+                continue;
+            const resolved = typeof raw.path === "string" ? raw.path : resolveLinkTarget(input);
+            if (!resolved)
+                continue;
+            out.push({ input, path: resolved });
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+function saveLinks(cwd, links) {
+    const file = linksFilePath(cwd);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify({ links }, null, "\t") + "\n");
+}
+/**
+ * Turn the folder path the user entered — absolute, `~/path`, or relative to
+ * cwd — into an absolute filesystem path. Returns undefined for empty input.
+ */
+export function resolveLinkTarget(input) {
+    let value = input.trim();
+    if (!value)
+        return undefined;
+    if (value.startsWith("~/"))
+        value = path.join(os.homedir(), value.slice(2));
+    return path.resolve(value);
+}
+/** Resolve, validate and persist a new link. Idempotent on the resolved path. */
+export function addLink(cwd, input) {
+    const resolved = resolveLinkTarget(input);
+    if (!resolved)
+        return { ok: false, message: "Enter a folder path." };
+    if (path.resolve(cwd) === resolved)
+        return { ok: false, message: "Can't link a repo to itself." };
+    if (!isDir(resolved))
+        return { ok: false, message: `Not a directory: ${resolved}` };
+    const links = loadLinks(cwd);
+    if (links.some((l) => l.path === resolved))
+        return { ok: false, message: "Already linked." };
+    if (links.length >= MAX_LINKED_REPOS) {
+        return { ok: false, message: `At most ${MAX_LINKED_REPOS} linked repos.` };
+    }
+    links.push({ input: input.trim(), path: resolved });
+    saveLinks(cwd, links);
+    return { ok: true, message: `Linked ${resolved}` };
+}
+/** Remove a link by its resolved path. */
+export function removeLink(cwd, targetPath) {
+    const links = loadLinks(cwd).filter((l) => l.path !== targetPath);
+    saveLinks(cwd, links);
+}
+/** First AGENTS.md found inside a linked repo, or undefined. */
+function readLinkedAgents(repo) {
+    for (const rel of AGENTS_LOCATIONS) {
+        try {
+            const text = fs.readFileSync(path.join(repo, rel), "utf8");
+            if (text.trim())
+                return text;
+        }
+        catch {
+            // try the next location
+        }
+    }
+    return undefined;
+}
+function truncate(text, max) {
+    return text.length <= max ? text : text.slice(0, max) + "\n… (truncated)";
+}
+/**
+ * Render the linked-repos block for the agent's environment details. Returns ""
+ * when nothing is linked. Each repo's AGENTS.md is pulled in (when present) so
+ * the model knows the linked codebase without exploring it first.
+ */
+export function renderLinkedReposSection(cwd) {
+    const links = loadLinks(cwd).slice(0, MAX_LINKED_REPOS);
+    if (links.length === 0)
+        return "";
+    const parts = [
+        "## Linked Repositories",
+        "",
+        "This repository is linked to the repositories below — separate codebases on disk that are coupled to this one. When you change this repo, consider whether the change ripples into a linked repo: inspect the linked code for impact and, when relevant, propose (or make, if the user asks) the matching changes there. You can read and edit files in these repos directly by their absolute paths.",
+        "",
+    ];
+    for (const link of links) {
+        const exists = isDir(link.path);
+        parts.push(`### ${path.basename(link.path)} — \`${link.path}\`${exists ? "" : "  (path not found)"}`);
+        if (!exists) {
+            parts.push("");
+            continue;
+        }
+        const agents = readLinkedAgents(link.path);
+        parts.push("");
+        if (agents) {
+            parts.push("Its AGENTS.md:");
+            parts.push("");
+            parts.push(truncate(agents.trim(), MAX_AGENTS_CHARS));
+        }
+        else {
+            parts.push("(no AGENTS.md found — explore the repo directly if you need its structure)");
+        }
+        parts.push("");
+    }
+    return parts.join("\n");
+}

package/dist/core/agent.js

@@ -11,8 +11,45 @@ import { getSessionFilePath, saveSession } from "./sessions.js";
 import { HookRunner } from "./hooks.js";
 import { loadMemoryFiles } from "../memory/loader.js";
 import { loadSkills } from "../skills/loader.js";
+import { renderLinkedReposSection } from "../config/links.js";
 const MAX_STEPS_PER_TURN = 50;
 const RESULT_PREVIEW_LINES = 6;
+/** How many times to automatically re-establish a model request that fails
+ *  before producing any output (transient/connection errors). */
+const MAX_STREAM_RETRIES = 3;
+/** Transient failures worth auto-retrying: any transport/connection error (no
+ *  usable HTTP status — socket reset, DNS, timeout, TLS drop) plus 5xx/408/429
+ *  server responses. Real 4xx client errors (auth, bad request) are not retried. */
+function isRetryableStreamError(error) {
+    const err = error;
+    const status = Number(err?.status ?? err?.code);
+    if (Number.isFinite(status) && status !== 0) {
+        return status >= 500 || status === 408 || status === 429;
+    }
+    return true;
+}
+function retryBackoffMs(attempt) {
+    return Math.min(500 * 2 ** attempt, 8000);
+}
+/** Sleep that settles early (rejecting with AbortError) if the signal fires, so
+ *  a user interrupt isn't stuck waiting out a retry backoff. */
+function interruptibleDelay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(new DOMException("aborted", "AbortError"));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new DOMException("aborted", "AbortError"));
+        };
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
 function detectRepo(cwd) {
     try {
         const remote = execSync("git config --get remote.origin.url", {
@@ -219,6 +256,7 @@ export class Agent {
         const timeZoneOffsetHours = Math.floor(Math.abs(timeZoneOffset));
         const timeZoneOffsetMinutes = Math.abs(Math.round((Math.abs(timeZoneOffset) - timeZoneOffsetHours) * 60));
         const timeZoneOffsetStr = `${timeZoneOffset >= 0 ? "+" : "-"}${timeZoneOffsetHours}:${timeZoneOffsetMinutes.toString().padStart(2, "0")}`;
+        const linkedRepos = renderLinkedReposSection(this.options.cwd);
         return `# Environment Details
 
 ## Current Workspace Directory (${this.options.cwd}) Files
@@ -226,7 +264,7 @@ ${files.join("\n") || "(empty directory)"}
 ${files.length >= 200 ? "\n(File list truncated.)" : ""}
 
 ${git}
-
+${linkedRepos ? `\n${linkedRepos}` : ""}
 ## Current Time
 Current time in ISO 8601 UTC format: ${now.toISOString()}
 User time zone: ${timeZone}, UTC${timeZoneOffsetStr}`;
@@ -420,7 +458,13 @@ User time zone: ${timeZone}, UTC${timeZoneOffsetStr}`;
                 },
             ];
             let summary = "";
-            for await (const chunk of this.client.createMessage(this.systemPrompt, request, [], signal)) {
+            for await (const chunk of this.streamWithRetry(() => this.client.createMessage(this.systemPrompt, request, [], signal), signal, () => {
+                // Compaction only streams text (committed once at the end), so a
+                // mid-stream retry just discards the partial summary.
+                summary = "";
+                onEvent({ type: "stream-reset" });
+                return true;
+            })) {
                 if (signal.aborted)
                     throw new DOMException("aborted", "AbortError");
                 if (chunk.type === "text") {
@@ -466,28 +510,102 @@ User time zone: ${timeZone}, UTC${timeZoneOffsetStr}`;
             onEvent({ type: "turn-end" });
         }
     }
+    /**
+     * Consume a model stream, automatically re-establishing the request up to
+     * MAX_STREAM_RETRIES times on a transient/connection failure. A user abort is
+     * never retried.
+     *
+     * Before the first chunk of an attempt nothing has streamed, so the retry is
+     * always clean. Once chunks have streamed, retrying would duplicate on-screen
+     * output — so we only retry mid-stream when the caller supplies `onRestart` and
+     * it returns true, meaning it rolled the partial output back (cleared buffers,
+     * reset accumulators). If it can't (e.g. a row was already committed), the error
+     * propagates.
+     */
+    async *streamWithRetry(makeStream, signal, onRestart) {
+        for (let attempt = 0;; attempt++) {
+            let produced = false;
+            try {
+                for await (const chunk of makeStream()) {
+                    produced = true;
+                    yield chunk;
+                }
+                return;
+            }
+            catch (error) {
+                if (signal.aborted || error.name === "AbortError")
+                    throw error;
+                if (attempt >= MAX_STREAM_RETRIES || !isRetryableStreamError(error))
+                    throw error;
+                // Output already streamed this attempt: only retry if the caller can
+                // cleanly roll it back, otherwise a restart would duplicate it.
+                if (produced && !(onRestart?.() ?? false))
+                    throw error;
+                const delayMs = retryBackoffMs(attempt);
+                this.options.callbacks.onEvent({
+                    type: "system",
+                    message: `Connection to the model failed (${error.message}). Retrying ${attempt + 1}/${MAX_STREAM_RETRIES} in ${Math.ceil(delayMs / 1000)}s…`,
+                    isError: false,
+                });
+                await interruptibleDelay(delayMs, signal);
+            }
+        }
+    }
     /** Run one model request + tool execution round. Returns true when the turn is over. */
     async runStep() {
         const { onEvent } = this.options.callbacks;
         const signal = this.abortController.signal;
         let assistantText = "";
-        let hadReasoning = false;
+        // A reasoning segment is "open" from its first delta until visible content
+        // (text or a tool call) begins. We emit reasoning-done at that transition so
+        // "Thought for Ns" reflects only the thinking time — not the answer that
+        // follows — and the live "Thinking" block stops before the answer streams.
+        // A fresh segment can re-open if the model interleaves reasoning with content.
+        let reasoningOpen = false;
         let reasoningStart = 0;
         let reasoningDetails;
+        // Once a reasoning-done row is committed to the transcript we can't roll it
+        // back, so a mid-stream retry after that point isn't clean.
+        let reasoningRowCommitted = false;
+        const finalizeReasoning = () => {
+            if (reasoningOpen) {
+                reasoningOpen = false;
+                reasoningRowCommitted = true;
+                onEvent({ type: "reasoning-done", durationMs: Date.now() - reasoningStart });
+            }
+        };
         const toolCallsByIndex = new Map();
         let nextSyntheticIndex = 10000;
-        const stream = this.client.createMessage(this.systemPrompt, this.outgoingMessages(), getActiveTools(this.mcp), signal);
+        // Roll back this step's partial output so streamWithRetry can restart a
+        // dropped stream mid-flight. Tools only run after the stream completes, so
+        // nothing irreversible has happened yet; the one thing we can't undo is an
+        // already-committed reasoning row, so we decline the restart in that case.
+        const rollbackForRetry = () => {
+            if (reasoningRowCommitted)
+                return false;
+            assistantText = "";
+            reasoningOpen = false;
+            reasoningStart = 0;
+            reasoningDetails = undefined;
+            toolCallsByIndex.clear();
+            nextSyntheticIndex = 10000;
+            onEvent({ type: "stream-reset" });
+            return true;
+        };
+        const stream = this.streamWithRetry(() => this.client.createMessage(this.systemPrompt, this.outgoingMessages(), getActiveTools(this.mcp), signal), signal, rollbackForRetry);
         for await (const chunk of stream) {
             if (signal.aborted)
                 throw new DOMException("aborted", "AbortError");
             switch (chunk.type) {
                 case "text":
+                    // Visible content begins — the reasoning phase (if any) is over.
+                    finalizeReasoning();
                     assistantText += chunk.text;
                     onEvent({ type: "text-delta", text: chunk.text });
                     break;
                 case "reasoning":
-                    if (!hadReasoning) {
-                        hadReasoning = true;
+                    if (!reasoningOpen) {
+                        reasoningOpen = true;
                         reasoningStart = Date.now();
                     }
                     onEvent({ type: "reasoning-delta", text: chunk.text });
@@ -497,6 +615,8 @@ User time zone: ${timeZone}, UTC${timeZoneOffsetStr}`;
                     reasoningDetails = chunk.details;
                     break;
                 case "native_tool_calls":
+                    // A tool call also ends the reasoning phase.
+                    finalizeReasoning();
                     for (const tc of chunk.toolCalls) {
                         const index = tc.index ?? nextSyntheticIndex++;
                         let pending = toolCallsByIndex.get(index);
@@ -525,9 +645,8 @@ User time zone: ${timeZone}, UTC${timeZoneOffsetStr}`;
                     break;
             }
         }
-        if (hadReasoning) {
-            onEvent({ type: "reasoning-done", durationMs: Date.now() - reasoningStart });
-        }
+        // A reasoning-only turn (no following text/tool content) still needs closing.
+        finalizeReasoning();
         if (assistantText) {
             onEvent({ type: "text-done" });
         }

package/dist/memory/loader.js

@@ -11,8 +11,8 @@ import { getConfigDir } from "../config/settings.js";
  * first), with closer-to-cwd and higher-precedence types winning:
  *
  *   1. User memory:   ~/.orbcode/AGENTS.md
- *   2. Project memory: AGENTS.md and .orbcode/AGENTS.md in cwd and every
- *      parent directory (closer-to-cwd wins)
+ *   2. Project memory: AGENTS.md and .orb/AGENTS.md (and the legacy
+ *      .orbcode/AGENTS.md) in cwd and every parent directory (closer-to-cwd wins)
  *   3. Local memory:   AGENTS.local.md in cwd and parents (highest precedence)
  *
  * Memory files support `@path` include directives (relative, `~/`, or
@@ -118,9 +118,11 @@ export function loadMemoryFiles(cwd = process.cwd()) {
     const files = [];
     // 1. User memory (~/.orbcode/AGENTS.md)
     files.push(...loadWithIncludes(path.join(getConfigDir(), "AGENTS.md"), "user", processed, 0));
-    // 2. Project memory (AGENTS.md + .orbcode/AGENTS.md), root -> cwd
+    // 2. Project memory (AGENTS.md + .orb/AGENTS.md), root -> cwd. The legacy
+    //    .orbcode/AGENTS.md location is still read for backward compatibility.
     for (const dir of ancestorDirs(cwd).reverse()) {
         files.push(...loadWithIncludes(path.join(dir, "AGENTS.md"), "project", processed, 0));
+        files.push(...loadWithIncludes(path.join(dir, ".orb", "AGENTS.md"), "project", processed, 0));
         files.push(...loadWithIncludes(path.join(dir, ".orbcode", "AGENTS.md"), "project", processed, 0));
     }
     // 3. Local memory (AGENTS.local.md), root -> cwd — highest precedence

package/dist/prompts/system.js

@@ -32,13 +32,13 @@ You have tools at your disposal to solve the coding task. Follow these rules reg
 
 If you intend to call multiple tools and there are no dependencies between the tool calls, make all of the independent tool calls in parallel. Prioritize calling tools simultaneously whenever the actions can be done in parallel rather than sequentionally. For example, when reading 3 files, run 3 tool calls in parallel to read all 3 files into context at the same time. Maximize use of parallel tool calls where possible to increase speed and efficiency. However, if some tool calls depend on previous calls to inform dependent values like the parameters, do NOT call these tools in parallel and instead call them sequentially. Never use placeholders or guess missing parameters in tool calls.
 
-# Maximize Context Understanding
+# Gather Enough Context, Then Act
 
-Be THOROUGH when gathering information. Make sure you have the FULL picture before replying. Use additional tool calls or clarifying questions as needed.
-TRACE every symbol back to its definitions and usages so you fully understand it.
-Look past the first seemingly relevant result. EXPLORE alternative implementations, edge cases, and varied search terms until you have COMPREHENSIVE coverage of the topic.
+Speed matters: your goal is the correct change in the fewest tool calls, not exhaustive coverage. Scale exploration to the task. A small, localized change typically needs about 3-6 calls — locate the code, read the region and its immediate callers, check conventions — while only wide refactors justify long exploration.
 
-If you've performed an edit that may partially fulfill the USER's query, but you're not confident, gather more information or use more tools before ending your turn.
+You have enough context when you know exactly which files and lines to change, you have seen the surrounding code's conventions, and you know how the code you are touching is used. From that point, every further search or read is waste: stop exploring and make the edit. Before each additional call, ask whether its result could change your edit; if not, skip it. Trace only the symbols your change actually depends on, never re-read regions you have already seen, and never re-verify facts you have already established.
+
+Never edit code you have not read. If after an edit you are genuinely unsure it fulfills the USER's request, verify that specific doubt with one targeted check — do not relaunch broad exploration.
 
 Bias towards not asking the user for help if you can find the answer yourself.
 
@@ -65,7 +65,7 @@ Your system prompt may include an "Available Skills" section listing skills by n
 
 Tools whose names start with \`mcp__\` are provided by external MCP servers the user has configured. They work exactly like native tools — call them with the standard tool call format when the task requires their capabilities. Their descriptions and parameter schemas come from the MCP servers.
 
-CRITICAL: For any task, small or big, you will always and always use the update_todo_list tool to create the TODO list, always keep is upto date with updates to the status and updating/editing the list as needed.`;
+Use the update_todo_list tool to create and maintain a TODO list for any multi-step task (3 or more steps), keeping statuses up to date as you work. For trivial tasks that need only one or two steps, skip the todo list and just do the work.`;
 const toolGuide = `
 Common tool calls and explanations
 
@@ -117,20 +117,15 @@ Common tool calls and explanations
 }
 \`\`\`
 
-**Example** (editing across multiple files):
-\`\`\`json
-{
-  "edits": [
-    {"file_path": "/path/to/api.ts", "old_string": "v1", "new_string": "v2"},
-    {"file_path": "/path/to/config.ts", "old_string": "version: 1", "new_string": "version: 2"}
-  ]
-}
-\`\`\`
-
 **Guidance for choosing between file_edit and multi_file_edit**:
 - 1 edit → \`file_edit\`
 - 2+ edits → \`multi_file_edit\` (always)
 
+**Editing discipline (CRITICAL)**:
+- ALWAYS copy \`old_string\` verbatim from a read_file result obtained in the same turn. NEVER reconstruct indentation or whitespace from memory — this is especially important in tab-indented files, where a reconstructed \`old_string\` will silently mismatch.
+- After any successful edit, treat all earlier reads of that file as stale. Re-read the region with read_file before editing the same area of the file again.
+- If one edit in a \`multi_file_edit\` batch fails with a string mismatch, STOP and re-read the file before retrying that edit. Do not guess at a corrected \`old_string\` — guessed corrections compound the mismatch.
+
 ## read_file Tool Usage
 
 The \`read_file\` tool reads file contents with optional offset and limit. Use it to examine code before making changes or to discuss specific sections.
@@ -141,33 +136,9 @@ The \`read_file\` tool reads file contents with optional offset and limit. Use i
 - \`offset\` (optional): Starting line number (1-indexed). Defaults to 1.
 - \`limit\` (optional): Maximum number of lines to read. If not specified, reads the complete file. Default and maximum limit is 1000 lines.
 
-### Parameters Schema
-\`\`\`typescript
-{
-  file_path: string,    // Absolute path to file (required)
-  offset?: number,      // Starting line (1-indexed), defaults to 1
-  limit?: number        // Max lines to read, omit to read entire file
-}
-\`\`\`
-
-### Examples
-
-**Read entire file:**
-\`\`\`json
-{
-  "file_path": "/Users/username/project/src/App.tsx"
-}
-\`\`\`
-
-**Read first 50 lines:**
-\`\`\`json
-{
-  "file_path": "/Users/username/project/src/App.tsx",
-  "limit": 50
-}
-\`\`\`
+### Example
 
-**Read lines 100-150 (50 lines starting at line 100):**
+**Read lines 100-150:**
 \`\`\`json
 {
   "file_path": "/Users/username/project/src/App.tsx",
@@ -176,43 +147,17 @@ The \`read_file\` tool reads file contents with optional offset and limit. Use i
 }
 \`\`\`
 
-### Workflow: When You Don't Know Line Numbers
-
-**Step 1:** Use \`search_files\` to find the code:
-\`\`\`json
-{
-  "path": "src",
-  "regex": "function handleSubmit",
-  "file_pattern": "*.ts"
-}
-\`\`\`
-
-**Step 2:** Note the line number from search results (e.g., line 45)
-
-**Step 3:** Read that section with \`read_file\`:
-\`\`\`json
-{
-  "file_path": "/Users/username/project/src/Form.tsx",
-  "offset": 40,
-  "limit": 50
-}
-\`\`\`
+Parameter rules: \`file_path\` must be an absolute path; \`offset\` and \`limit\` must be >= 1 if specified; omit \`limit\` to read from \`offset\` to the end. Call the tool multiple times to read multiple files.
 
-### Parameter Rules
+CRITICAL: \`offset\` is what targets a region — \`limit\` alone reads the TOP of the file. To inspect line N (e.g. from search results), you MUST pass \`offset\` ≈ N-20 together with \`limit\`. Before sending the call, confirm \`offset\` is present whenever you are aiming at a specific line.
 
-1. \`file_path\` must be an absolute path
-2. \`offset\` must be >= 1 if specified
-3. \`limit\` must be >= 1 if specified
-4. If \`limit\` is omitted, the entire file is read from \`offset\`
+When you don't know line numbers: use \`search_files\` to locate the code, note the line number from the results, then \`read_file\` that region with surrounding context.
 
-### Common Patterns
+### Reading Strategy
 
-| Use Case | Parameters |
-|----------|-----------|
-| Read entire file | \`file_path\` only |
-| Read from start | \`limit: 50\` |
-| Read middle section | \`offset: 100, limit: 50\` |
-| Read from a specific line to end | \`offset: 200\` |
+- When investigating a bug, read whole functions or logical regions in ONE call rather than small slivers. Prefer one 150-line read over five 30-line reads — fragmented reads lose context and waste calls.
+- Budget your re-reads: if you have already read a region and have not edited it since, work from what you have instead of fetching it again. Re-read only when the file has changed or you genuinely lack the detail.
+- After every read, verify the output matches the parameters you sent. If you meant to read around line N but the result starts at line 1, you omitted \`offset\` — re-issue the call with \`offset\` set. NEVER re-read the top of the file expecting a different result.
 
 
 # execute_command
@@ -226,7 +171,9 @@ The tool accepts these parameters:
 - \`command\` (required): The CLI command to execute. Must be valid for the user's operating system.
 - \`cwd\` (optional): The working directory to execute the command in. If not provided, the current working directory is used. Ensure this is always an absolute path (starting with \`/\`, or a drive letter like \`C:\\\` on Windows). If you are running the command in the root directly, skip this parameter. The command executor is defaulted to run in the root directory. You already have the Current Workspace Directory in the Environment Details section.
 
-CRITICAL: If the command is a very long running process, prefer to let the user to that they can run it manually in thier terminal. If the user specifically requests to run a long running command, you may proceed.
+CRITICAL: If the command is a very long running process, prefer to let the user know so they can run it manually in their terminal. If the user specifically requests to run a long running command, you may proceed.
+
+Command validity rules: a command is never empty, never just \`:\`, never a bare single word with no arguments, and never contains tool-call markup tokens or angle-bracket tags of any kind. Commands must be valid for the user's operating system, shell, and current working directory.
 
 ## search_files
 
@@ -262,90 +209,29 @@ The \`search_files\` tool allows you to search for patterns across files in a di
   "file_pattern": null
 }
 
-// Search in JSX/TSX files only
-{
-  "path": "src/components",
-  "regex": "useState",
-  "file_pattern": "*.{jsx,tsx}"
-}
-
-// Search in nested directories
-{
-  "path": ".",
-  "regex": "API_KEY",
-  "file_pattern": "**/*.env*"
-}
-\`\`\`
-
-### ❌ INCORRECT Examples
-\`\`\`json
-// WRONG - Unquoted file_pattern (will cause JSON error)
-{
-  "path": "src",
-  "regex": "import",
-  "file_pattern": *.js
-}
-
-// WRONG - Missing file_pattern entirely
-{
-  "path": "src",
-  "regex": "import"
-}
-
-// WRONG - Empty string instead of null
-{
-  "path": "src",
-  "regex": "import",
-  "file_pattern": ""
-}
 \`\`\`
 
-### Regex Pattern Tips
-
-- Use Rust regex syntax (similar to PCRE)
-- Escape special characters: \`\\.\`, \`\\(\`, \`\\[\`, etc.
-- Common patterns:
-  - \`"word"\` - literal match
-  - \`"\\bword\\b"\` - word boundary match
-  - \`"function\\s+\\w+"\` - function declarations
-  - \`"import.*from\\s+['\\"].*['\\"]"\` - import statements
+The regex uses Rust syntax (similar to PCRE); escape special characters like \`\\.\` and \`\\(\`. \`file_pattern\` uses glob syntax: \`"*.ts"\`, \`"*.{jsx,tsx}"\`, \`"**/*.json"\`. When in doubt, use \`null\` to search all files.
 
-### File Pattern Glob Syntax
+### Search Hygiene
 
-When using a string value for \`file_pattern\`:
-- \`"*.js"\` - All .js files in directory
-- \`"*.{js,ts}"\` - All .js and .ts files
-- \`"**/*.json"\` - All .json files recursively
-- \`"test_*.py"\` - Files starting with test_
-- \`"src/**/*.tsx"\` - All .tsx files under src/
-
-**When in doubt, use \`null\` to search all files.**
-
-### Parameter Validation Checklist
-
-Before submitting, verify:
-- ✅ \`path\` is a string (directory path)
-- ✅ \`regex\` is a string (valid Rust regex)
-- ✅ \`file_pattern\` is EITHER a quoted string OR null
-- ✅ All three parameters are present
-- ✅ No unquoted glob patterns like \`*.js\`
+- Exclude test, spec, and mock paths from discovery searches by default (\`__tests__\`, \`*.spec.*\`, \`*.test.*\`, \`__mocks__\`) unless the task itself is about tests. They pollute results and bury the implementation you are looking for.
+- Scope \`path\` to the narrowest plausible directory instead of searching from the repository root.
+- If a search returns hundreds of hits, tighten the regex or \`file_pattern\` and search again. Do not scan through the dump.
 
 ### Remember
 
 **Always quote the file_pattern value or use null. Never use bare/unquoted glob patterns.**
 
-## execute_command
+## Verifying tool results and avoiding loops
+
+- After EVERY tool call, verify the output actually matches the parameters you sent (correct file, correct line range, correct directory). A result that does not reflect your parameters means the call was malformed — fix the call, do not reason from the bad output.
+- If two consecutive identical tool calls produce identical results, you are in a loop. Change the call or change the strategy. NEVER repeat the same call a third time.
 
-CRITICAL:
-1. A command never starts with \`:\`
-2. A command never contains tool-call markup tokens or angle-bracket tags of any kind
-3. A command is never empty or \`:\`
-4. A command is never a single word or a single word with a space
-5. Commands are always valid for the user's operating system
-6. Commands are always valid for the user's shell
-7. Commands are always valid with executable permissions
-8. Commands are always valid with the user's current working directory
+## Plan before editing
 
+- Investigate first, edit second. Once the root cause is confirmed, write out the full change plan — which files, the exact locations, and the edit order — BEFORE touching anything.
+- Then execute the edits in one pass (batched via \`multi_file_edit\`) and verify with a single typecheck/build at the end, rather than alternating between editing and checking.
 
 ## update_todo_list
 
@@ -353,27 +239,14 @@ CRITICAL:
 Replace the entire TODO list with an updated checklist reflecting the current state. Always provide the full list; the system will overwrite the previous one. This tool is designed for step-by-step task tracking, allowing you to confirm completion of each step before updating, update multiple task statuses at once (e.g., mark one as completed and start the next), and dynamically add new todos discovered during long or complex tasks.
 
 **Checklist Format:**
-- Use a single-level markdown checklist (no nesting or subtasks).
-- List todos in the intended execution order.
-- Status options:
-	 - [ ] Task description (pending)
-	 - [x] Task description (completed)
-	 - [-] Task description (in progress)
-
-**Status Rules:**
-- [ ] = pending (not started)
-- [x] = completed (fully finished, no unresolved issues)
-- [-] = in_progress (currently being worked on)
+- Use a single-level markdown checklist (no nesting or subtasks), in intended execution order.
+- Statuses: \`[ ]\` pending, \`[x]\` completed (fully finished, no unresolved issues), \`[-]\` in progress.
 
 **Core Principles:**
-- Before updating, always confirm which todos have been completed since the last update.
-- You may update multiple statuses in a single update (e.g., mark the previous as completed and the next as in progress).
-- When a new actionable item is discovered during a long or complex task, add it to the todo list immediately.
-- Do not remove any unfinished todos unless explicitly instructed.
-- Always retain all unfinished tasks, updating their status as needed.
-- Only mark a task as completed when it is fully accomplished (no partials, no unresolved dependencies).
-- If a task is blocked, keep it as in_progress and add a new todo describing what needs to be resolved.
-- Remove tasks only if they are no longer relevant or if the user requests deletion.
+- Update multiple statuses in a single call (e.g., mark the previous task completed and the next in progress).
+- Add newly discovered actionable items immediately. Retain all unfinished tasks; remove one only if it is no longer relevant or the user asks.
+- Mark a task completed only when fully accomplished. If blocked, keep it in_progress and add a todo describing what must be resolved.
+- Keep the todo list AHEAD of the work, not behind it: it is a steering tool, not a changelog. Lay out upcoming steps before you start them instead of only recording steps after they are finished.
 
 IMPORTANT: Use attempt_completion tool when you have completed the task. This signals that you are done.
 `;

package/dist/ui/App.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import { Box, Static, Text, useApp, useInput } from "ink";
 import open from "open";
+import * as path from "node:path";
 import { COLORS, VERSION } from "../branding.js";
 import { BUILTIN_AXON_MODELS, getModel, isValidAxonModel, } from "../api/models.js";
 import { LoginView } from "./LoginView.js";
@@ -23,6 +24,8 @@ import { ModelPicker } from "./components/ModelPicker.js";
 import { SessionPicker } from "./components/SessionPicker.js";
 import { listSessions } from "../core/sessions.js";
 import { RowView } from "./components/rows.js";
+import { LinkManager } from "./components/LinkManager.js";
+import { addLink, loadLinks, removeLink, resolveProjectDir, } from "../config/links.js";
 const SLASH_COMMANDS = [
     { name: "/help", description: "show available commands" },
     { name: "/model", description: "select the Axon model to use" },
@@ -37,6 +40,10 @@ const SLASH_COMMANDS = [
         description: "summarize the conversation to free up context",
     },
     { name: "/tasks", description: "show the current task list" },
+    {
+        name: "/task",
+        description: "reference a previous task in the current conversation",
+    },
     {
         name: "/status",
         description: "show session status (model, context, cost, account)",
@@ -46,6 +53,10 @@ const SLASH_COMMANDS = [
         name: "/init",
         description: "analyze this codebase and create an AGENTS.md",
     },
+    {
+        name: "/link",
+        description: "link other repos so changes here are checked against them",
+    },
     {
         name: "/mcp",
         description: "manage MCP servers — enable, disable, reconnect, view status",
@@ -117,13 +128,21 @@ function usageLines(profile) {
     }
     return lines;
 }
-const INIT_PROMPT = `Analyze this codebase and create an AGENTS.md file containing:
-1. A short overview of what the project does
-2. Build, run, lint and test commands
-3. Architecture and code structure (key directories and what lives in them)
-4. Code style conventions used in this repo (imports, formatting, naming, error handling)
+function buildInitPrompt(agentsPath) {
+    return `Analyze this codebase and write a concise AGENTS.md that reduces cold-start for future coding sessions. Create or update the file at exactly this path:
+
+  ${agentsPath}
 
-If an AGENTS.md already exists, improve it. Keep it under ~60 lines so it is cheap to include in future prompts.`;
+Investigate first — read the directory layout, key config files, and a few representative source files — then write. Keep it under ~150 lines so it stays cheap to include in every future prompt. Cover, briefly:
+1. What the project does (1-2 lines) and its main tech stack.
+2. Project structure — the key directories/files and what each is responsible for.
+3. Architecture — how the main pieces fit together (entry points, data/control flow).
+4. Business-logic / domain mapping — where the core domain concepts live in the code.
+5. Notable code patterns and conventions to follow (imports, naming, error handling, tests).
+6. The common build, run, lint and test commands.
+
+Favor durable facts over volatile detail. If an AGENTS.md already exists at that path, refine it rather than rewriting from scratch.`;
+}
 // Ported from the Orbital extension's commit slash command (commitCommandResponse).
 const buildCommitPrompt = (userInput) => `The user has explicitly asked you to check pending changes and generate detailed commit messages. You MUST now help them with this.
 
@@ -163,6 +182,44 @@ Instructions:
 5. Finish with a short summary: all findings ordered by severity, and an overall verdict on whether the changes are safe to merge.
 
 This is a review only — do NOT modify any files. Present the findings to the user.${userInput ? `\n\nThe user provided the following input with the code-review command:\n${userInput}` : ""}`;
+const MAX_TASK_CONVERSATION_CHARS = 8000;
+function extractConversation(session) {
+    const lines = [];
+    for (const message of session.messages) {
+        if (message.role === "user" && typeof message.content === "string") {
+            const match = /<user_query>\n?([\s\S]*?)\n?<\/user_query>/.exec(message.content);
+            if (match)
+                lines.push(`User: ${match[1]}`);
+        }
+        else if (message.role === "assistant" &&
+            typeof message.content === "string" &&
+            message.content.trim()) {
+            lines.push(`Assistant: ${message.content}`);
+        }
+    }
+    return lines.join("\n\n");
+}
+function buildTaskReferencePrompt(session) {
+    const conversation = extractConversation(session);
+    const truncated = conversation.length > MAX_TASK_CONVERSATION_CHARS
+        ? conversation.slice(0, MAX_TASK_CONVERSATION_CHARS) +
+            "\n\n[... conversation truncated ...]"
+        : conversation;
+    return `The user has referenced a previous task. Here is the conversation from that task:
+
+<previous_task title="${session.title || session.id}">
+${truncated}
+</previous_task>
+
+Please summarize this previous task and add it as a reference for the current task. The summary should capture:
+- What the task was about
+- What was accomplished
+- Key decisions made
+- Files that were created or modified
+- Any remaining work
+
+Present the summary in a clear, organized format. This summary will serve as context for the current task.`;
+}
 let rowCounter = 0;
 function rowId() {
     return `row-${rowCounter++}`;
@@ -195,6 +252,10 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
     const [queuedMessages, setQueuedMessages] = useState([]);
     const [modelPickerOpen, setModelPickerOpen] = useState(false);
     const [resumableSessions, setResumableSessions] = useState(null);
+    const [taskPickerSessions, setTaskPickerSessions] = useState(null);
+    const [linkManagerOpen, setLinkManagerOpen] = useState(false);
+    const [links, setLinks] = useState([]);
+    const [linkStatus, setLinkStatus] = useState("");
     // MCP manager (created once, shared across agents in this process). Null until
     // the first agent is created so we don't spawn servers before login.
     const mcpManagerRef = useRef(null);
@@ -326,6 +387,17 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
                 setStreamingText("");
                 setBusyLabel("Working");
                 break;
+            case "stream-reset":
+                // An auto-retry is re-streaming this step from scratch — drop the
+                // partial text/reasoning shown for the failed attempt so it doesn't
+                // duplicate. (Committed rows are untouched; the agent only resets when
+                // nothing has been committed yet.)
+                textBufferRef.current = "";
+                setStreamingText("");
+                reasoningBufferRef.current = "";
+                setStreamingReasoning("");
+                setBusyLabel("Working");
+                break;
             case "tool-start":
                 setBusyLabel("Working");
                 break;
@@ -467,6 +539,16 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
             text: `Resumed session: ${session.title || session.id}`,
         });
     }, [createAgent, pushRow, resetTranscript]);
+    const handleTaskSelect = useCallback((session) => {
+        setTaskPickerSessions(null);
+        pushRow({
+            kind: "user",
+            text: `/task (referencing: ${session.title || session.id})`,
+        });
+        setBusy(true);
+        setBusyLabel("Thinking");
+        void getAgent().runTurn(buildTaskReferencePrompt(session));
+    }, [getAgent, pushRow]);
     const switchModel = useCallback((modelId) => {
         const updated = { ...loadSettings(), model: modelId };
         setSettings(updated);
@@ -589,6 +671,22 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
                 setResumableSessions(sessions);
                 break;
             }
+            case "/task": {
+                if (!getAuthToken(settings)) {
+                    setView("login");
+                    break;
+                }
+                const taskSessions = listSessions(process.cwd()).filter((s) => s.id !== agentRef.current?.taskId);
+                if (taskSessions.length === 0) {
+                    pushRow({
+                        kind: "info",
+                        text: "No previous tasks found for this directory.",
+                    });
+                    break;
+                }
+                setTaskPickerSessions(taskSessions);
+                break;
+            }
             case "/compact":
                 if (!getAuthToken(settings)) {
                     setView("login");
@@ -633,7 +731,7 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
                 }
                 break;
             }
-            case "/init":
+            case "/init": {
                 if (!getAuthToken(settings)) {
                     setView("login");
                     break;
@@ -641,7 +739,14 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
                 pushRow({ kind: "user", text: "/init" });
                 setBusy(true);
                 setBusyLabel("Thinking");
-                void getAgent().runTurn(INIT_PROMPT);
+                const agentsPath = path.join(resolveProjectDir(process.cwd()), "AGENTS.md");
+                void getAgent().runTurn(buildInitPrompt(agentsPath));
+                break;
+            }
+            case "/link":
+                setLinks(loadLinks(process.cwd()));
+                setLinkStatus("");
+                setLinkManagerOpen(true);
                 break;
             case "/mcp": {
                 const manager = mcpManagerRef.current;
@@ -995,14 +1100,25 @@ export function App({ initialView, initialPrompt, initialSession, systemPromptOv
         !modelPickerOpen &&
         !mcpPickerOpen &&
         !mcpMigrationEntries &&
-        !resumableSessions;
+        !resumableSessions &&
+        !taskPickerSessions &&
+        !linkManagerOpen;
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: rows, children: (row) => _jsx(RowView, { row: row }, row.id) }, staticKey), view === "login" ? (_jsx(LoginSection, { onLogin: handleLogin })) : (_jsxs(Box, { flexDirection: "column", children: [updateInfo?.updateAvailable && updateInfo.latest && (_jsxs(Box, { marginTop: 1, flexDirection: "column", borderStyle: "round", borderColor: COLORS.warning, paddingX: 2, alignSelf: "flex-start", children: [_jsxs(Text, { color: COLORS.warning, bold: true, children: ["\u2191 Update available: v", updateInfo.current, " \u2192 v", updateInfo.latest] }), _jsxs(Text, { children: ["Run ", _jsx(Text, { color: COLORS.accent, children: "orbcode update" }), " to install the latest version, then relaunch."] })] })), streamingReasoning && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: COLORS.thinking, italic: true, children: "\u2726 Thinking\u2026" }), _jsx(Box, { paddingLeft: 2, children: _jsx(Text, { dimColor: true, italic: true, children: tail(streamingReasoning, expandReasoningRef.current ? 30 : 3) }) })] })), streamingText && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { children: [_jsx(Text, { color: COLORS.primary, children: "\u25CF " }), streamingText] }) })), taskLines.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 1, children: [_jsx(Text, { dimColor: true, bold: true, children: "Tasks" }), taskLines.slice(0, 10).map((line, i) => (_jsx(Text, { dimColor: /^[-*]\s*\[x\]/i.test(line), children: line
                                     .replace(/^[-*]\s*\[x\]/i, "  ■")
                                     .replace(/^[-*]\s*\[-\]/, "  ◧")
                                     .replace(/^[-*]\s*\[ \]/, "  □") }, i))), taskLines.length > 10 && (_jsxs(Text, { dimColor: true, children: [" \u2026 ", taskLines.length - 10, " more"] }))] })), modelPickerOpen && (_jsx(Box, { marginTop: 1, children: _jsx(ModelPicker, { currentId: settings.model, onSelect: (modelId) => {
                                 setModelPickerOpen(false);
                                 switchModel(modelId);
-                            }, onCancel: () => setModelPickerOpen(false) }) })), resumableSessions && (_jsx(Box, { marginTop: 1, children: _jsx(SessionPicker, { sessions: resumableSessions, onSelect: handleResume, onCancel: () => setResumableSessions(null) }) })), pendingHookTrust && (_jsx(Box, { marginTop: 1, children: _jsx(HookTrustPrompt, { cwd: process.cwd(), commands: pendingHookTrust.commands, onDecision: resolveHookTrust }) })), pendingMcpApproval && (_jsx(Box, { marginTop: 1, children: _jsx(McpApprovalPrompt, { serverNames: pendingMcpApproval, onApprove: resolveMcpApproval }) })), mcpPickerOpen && mcpManagerRef.current && (_jsx(Box, { marginTop: 1, children: _jsx(McpPicker, { manager: mcpManagerRef.current, onChanged: () => {
+                            }, onCancel: () => setModelPickerOpen(false) }) })), resumableSessions && (_jsx(Box, { marginTop: 1, children: _jsx(SessionPicker, { sessions: resumableSessions, onSelect: handleResume, onCancel: () => setResumableSessions(null) }) })), taskPickerSessions && (_jsx(Box, { marginTop: 1, children: _jsx(SessionPicker, { sessions: taskPickerSessions, title: "Reference a previous task", onSelect: handleTaskSelect, onCancel: () => setTaskPickerSessions(null) }) })), linkManagerOpen && (_jsx(Box, { marginTop: 1, children: _jsx(LinkManager, { links: links, status: linkStatus, onAdd: (input) => {
+                                const result = addLink(process.cwd(), input);
+                                setLinkStatus(result.message);
+                                if (result.ok)
+                                    setLinks(loadLinks(process.cwd()));
+                            }, onRemove: (link) => {
+                                removeLink(process.cwd(), link.path);
+                                setLinks(loadLinks(process.cwd()));
+                                setLinkStatus(`Unlinked ${path.basename(link.path)}`);
+                            }, onClose: () => setLinkManagerOpen(false) }) })), pendingHookTrust && (_jsx(Box, { marginTop: 1, children: _jsx(HookTrustPrompt, { cwd: process.cwd(), commands: pendingHookTrust.commands, onDecision: resolveHookTrust }) })), pendingMcpApproval && (_jsx(Box, { marginTop: 1, children: _jsx(McpApprovalPrompt, { serverNames: pendingMcpApproval, onApprove: resolveMcpApproval }) })), mcpPickerOpen && mcpManagerRef.current && (_jsx(Box, { marginTop: 1, children: _jsx(McpPicker, { manager: mcpManagerRef.current, onChanged: () => {
                                 const m = mcpManagerRef.current;
                                 if (m)
                                     saveMcpApproval(process.cwd(), m.getEnabled(), m.getDisabled());

package/dist/ui/components/LinkManager.js

@@ -0,0 +1,65 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Box, Text, useInput } from "ink";
+import { COLORS } from "../../branding.js";
+/**
+ * Interactive manager for the `/link` command. The last row is a free-text
+ * input where the user types a folder path to add; existing links above it can
+ * be selected and removed. Mirrors FollowupPrompt's "input is the final virtual
+ * row" pattern.
+ */
+export function LinkManager({ links, status, onAdd, onRemove, onClose }) {
+    const [selected, setSelected] = useState(links.length);
+    const [draft, setDraft] = useState("");
+    const inputRow = links.length; // the free-text row sits after every link
+    const rowCount = links.length + 1;
+    const sel = Math.min(selected, inputRow); // clamp: list shrinks on removal
+    const isInput = sel === inputRow;
+    useInput((input, key) => {
+        if (key.escape) {
+            onClose();
+            return;
+        }
+        if (key.upArrow) {
+            setSelected((s) => (Math.min(s, inputRow) - 1 + rowCount) % rowCount);
+            return;
+        }
+        if (key.downArrow) {
+            setSelected((s) => (Math.min(s, inputRow) + 1) % rowCount);
+            return;
+        }
+        if (key.return) {
+            if (isInput) {
+                if (draft.trim()) {
+                    onAdd(draft.trim());
+                    setDraft("");
+                    // Stay on the input row so several repos can be added in a row.
+                    // rowCount == the new input-row index once a link is appended.
+                    setSelected(rowCount);
+                }
+            }
+            else {
+                onRemove(links[sel]);
+                setSelected(inputRow); // jump back to the input row after removing
+            }
+            return;
+        }
+        if (isInput) {
+            if (key.backspace || key.delete)
+                setDraft((d) => d.slice(0, -1));
+            else if (input && !key.ctrl && !key.meta)
+                setDraft((d) => d + input);
+        }
+        else if (input === "d" || key.backspace || key.delete) {
+            onRemove(links[sel]);
+            setSelected(inputRow);
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: COLORS.primary, paddingX: 1, children: [_jsx(Text, { bold: true, color: COLORS.primary, children: "Linked repositories" }), _jsx(Text, { dimColor: true, children: "Repos linked here are shared with the agent so changes can be checked across them." }), links.length === 0 && _jsx(Text, { dimColor: true, children: "  (none yet)" }), links.map((link, index) => (
+            // truncate-start keeps the meaningful tail of long paths visible
+            // instead of wrapping them onto the next line.
+            _jsxs(Text, { color: sel === index ? COLORS.accent : undefined, wrap: "truncate-start", children: [sel === index ? "❯ " : "  ", index + 1, ". ", link.path] }, link.path))), _jsxs(Text, { color: isInput ? COLORS.accent : undefined, children: [isInput ? "❯ " : "  ", "add a repo (folder path):"] }), isInput && (
+            // The typed/pasted path lives on its own line and truncates from
+            // the start, so a long path shows its tail + cursor without wrapping.
+            _jsxs(Text, { wrap: "truncate-start", children: ["    ", draft, _jsx(Text, { inverse: true, children: " " })] })), status && _jsx(Text, { dimColor: true, children: status }), _jsx(Text, { dimColor: true, children: "\u2191/\u2193 select \u00B7 enter add/remove \u00B7 d remove \u00B7 esc done" })] }));
+}

package/dist/ui/components/SessionPicker.js

@@ -16,7 +16,7 @@ function relativeTime(iso) {
     const days = Math.round(hours / 24);
     return `${days}d ago`;
 }
-export function SessionPicker({ sessions, onSelect, onCancel }) {
+export function SessionPicker({ sessions, onSelect, onCancel, title = "Resume a previous session" }) {
     const [selected, setSelected] = useState(0);
     useInput((input, key) => {
         if (key.upArrow) {
@@ -43,7 +43,7 @@ export function SessionPicker({ sessions, onSelect, onCancel }) {
     });
     const windowStart = Math.max(0, Math.min(selected - VISIBLE_ROWS + 1, sessions.length - VISIBLE_ROWS));
     const visible = sessions.slice(windowStart, windowStart + VISIBLE_ROWS);
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: COLORS.primary, paddingX: 1, children: [_jsx(Text, { bold: true, color: COLORS.primary, children: "Resume a previous session" }), windowStart > 0 && _jsxs(Text, { dimColor: true, children: ["  \u2191 ", windowStart, " more"] }), visible.map((session, i) => {
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: COLORS.primary, paddingX: 1, children: [_jsx(Text, { bold: true, color: COLORS.primary, children: title }), windowStart > 0 && _jsxs(Text, { dimColor: true, children: ["  \u2191 ", windowStart, " more"] }), visible.map((session, i) => {
                 const index = windowStart + i;
                 const isSelected = index === selected;
                 const userTurns = session.messages.filter((m) => m.role === "user").length;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matterailab/orbcode",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "OrbCode CLI — agentic coding in your terminal, powered by Axon models by MatterAI",
   "type": "module",
   "bin": {