nomoreide 0.1.89 → 0.1.91

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="assets/nomoreide-logo.png" alt="NoMoreIDE Logo" width="120" />
+<img src="assets/nomoreide-logo.svg" alt="NoMoreIDE Logo" width="120" />
 
 # NoMoreIDE
 
@@ -15,7 +15,21 @@
 
 Give your coding agents and yourself a **shared local control surface** for services, ports, logs, Git review, GitHub workflows, database work, and MCP workflows — no IDE required.
 
-[MCP Setup](#connect-your-ai-agent) · [CLI Reference](#cli) · [MCP Tools](#mcp-tools) · [Architecture](#architecture)
+[Product Tour](#product-tour) · [Download for macOS](#macos-desktop-app) · [MCP Setup](#connect-your-ai-agent) · [CLI Reference](#cli) · [Architecture](#architecture)
+
+</div>
+
+---
+
+## Product Tour
+
+<div align="center">
+
+<a href="https://www.nomoreide.com/#hero-demo">
+  <img src="assets/screenshots/product-tour.png" alt="NoMoreIDE Git Review showing running services, changed and staged files, an inline diff, commit controls, and the agent terminal dock" width="1200" />
+</a>
+
+<sub>Review a repository, inspect a diff, stage and commit changes, watch running services, and hand context to an agent without leaving the workbench. <a href="https://www.nomoreide.com/#hero-demo">Try the interactive demo</a>—it uses safe mock data.</sub>
 
 </div>
 
@@ -23,29 +37,33 @@ Give your coding agents and yourself a **shared local control surface** for serv
 
 ## What Is NoMoreIDE?
 
-NoMoreIDE is a lightweight process manager, Git reviewer, GitHub workflow surface, database workbench, log aggregator, and MCP server — all in one `npx` command. It gives AI coding agents (Claude Code, Codex CLI, Gemini CLI, and others) a safe, structured window into your running dev environment through the **Model Context Protocol (MCP)**, while also providing a terminal UI and a local React web dashboard for humans.
+NoMoreIDE is the shared local control plane between you and your coding agents. The native macOS app, web dashboard, TUI, CLI, and MCP server all operate on the same services, repositories, logs, databases, workflows, and agent configuration.
 
+- **For humans:** one place to run services, inspect logs and ports, review Git changes, manage GitHub work, browse databases, and open terminals.
+- **For agents:** structured MCP tools expose the same live project state to Claude Code, Codex CLI, Gemini CLI, and other MCP clients.
+- **For safety:** destructive Git operations are omitted, database writes require human approval, secrets are redacted from shared profiles, and NoMoreIDE does not kill processes it did not start.
+
+---
+
+## Download or Run NoMoreIDE
+
+### macOS Desktop App
+
+Prefer a native app? Download the latest universal DMG for both Apple silicon and Intel Macs:
+
+**[Download NoMoreIDE for macOS](https://www.nomoreide.com/#download)** · [View all releases](https://github.com/Rorogogogo/nomoreide/releases)
+
+> **First launch:** NoMoreIDE is currently unsigned and not notarized, so macOS will block it the first time you open it. After dragging NoMoreIDE to Applications, try to open it once, then go to **System Settings → Privacy & Security**, click **Open Anyway**, and confirm with Touch ID or your password.
+
+### CLI, Web UI, TUI, and MCP Server
+
+No global installation is required. Run the latest version with Node.js 20 or newer:
+
+```bash
+npx -y nomoreide
 ```
-┌──────────────────────────────────────────────────────┐
-│                    Your Project                       │
-│                                                      │
-│   Claude Code / Codex CLI / Gemini CLI               │
-│           │                                          │
-│     MCP (stdio)                                      │
-│           │                                          │
-│   ┌───────▼────────┐    ┌──────────────────────┐    │
-│   │  NoMoreIDE MCP │◄──►│  Process Manager      │    │
-│   │  Server        │    │  Log Store            │    │
-│   └───────┬────────┘    │  Git Manager          │    │
-│           │             │  Config Store         │    │
-│     HTTP API            └──────────────────────┘    │
-│           │                                          │
-│   ┌───────▼──────────────────────────┐              │
-│   │  Web UI  (localhost:4317)        │              │
-│   │  Terminal UI (nomoreide tui)     │              │
-│   └──────────────────────────────────┘              │
-└──────────────────────────────────────────────────────┘
-```
+
+Use the agent-specific commands below to connect NoMoreIDE as an MCP server.
 
 ---
 
@@ -168,6 +186,7 @@ graph TD
         GM[Git Manager]
         LS[Log Store]
         CS[Config Store<br/>nomoreide.config.json]
+        Desktop[macOS Desktop App]
         WS[Web Server<br/>:4317]
         TUI[Terminal UI]
     end
@@ -187,6 +206,9 @@ graph TD
     PM --> S2
     PM --> S3
     LS --> PM
+    Desktop --> PM
+    Desktop --> GM
+    Desktop --> LS
     WS --> PM
     WS --> GM
     WS --> LS
@@ -198,7 +220,7 @@ graph TD
 
 ## Feature Overview
 
-| Feature | CLI | TUI | Web UI | MCP |
+| Feature | CLI | TUI | Desktop / Web | MCP |
 |---|:---:|:---:|:---:|:---:|
 | Start / stop / restart services | ✓ | ✓ | ✓ | ✓ |
 | Bundle orchestration | ✓ | | ✓ | ✓ |

package/dist/core/agent-terminal.d.ts

@@ -3,10 +3,18 @@ export interface InteractiveAgentInvocation {
     shell: string;
     args: string[];
 }
+export interface InteractiveAgentOptions {
+    /** Prior session to reopen, from `listAgentTranscripts`. */
+    resumeId?: string;
+}
 /**
  * Both CLIs accept a positional initial prompt and queue it themselves until
  * the interactive TUI is ready. Passing it as an argument is what makes the
  * first prompt reliable — injecting keystrokes after spawn raced the TUI's
  * startup (trust dialogs, first paint) and the paste was silently dropped.
+ *
+ * A blank prompt starts the provider's interactive TUI without queueing a
+ * first turn. Resuming reopens a recorded session and replays its history, so
+ * an empty prompt there just returns to the conversation where it left off.
  */
-export declare function buildInteractiveAgentInvocation(provider: string, prompt: string): InteractiveAgentInvocation;
+export declare function buildInteractiveAgentInvocation(provider: string, prompt: string, { resumeId }?: InteractiveAgentOptions): InteractiveAgentInvocation;

package/dist/core/agent-terminal.js

@@ -1,20 +1,41 @@
 const CLAUDE_BIN = process.env.NOMOREIDE_CLAUDE_BIN || "claude";
 const CODEX_BIN = process.env.NOMOREIDE_CODEX_BIN || "codex";
+/**
+ * Session ids are spawned as argv entries rather than through a shell, so the
+ * risk is not injection but a malformed id starting with `-` and being read as
+ * a flag by the CLI. Both providers issue UUIDs, so anything else is refused.
+ */
+const SESSION_ID = /^[0-9a-fA-F-]{8,64}$/;
 /**
  * Both CLIs accept a positional initial prompt and queue it themselves until
  * the interactive TUI is ready. Passing it as an argument is what makes the
  * first prompt reliable — injecting keystrokes after spawn raced the TUI's
  * startup (trust dialogs, first paint) and the paste was silently dropped.
+ *
+ * A blank prompt starts the provider's interactive TUI without queueing a
+ * first turn. Resuming reopens a recorded session and replays its history, so
+ * an empty prompt there just returns to the conversation where it left off.
  */
-export function buildInteractiveAgentInvocation(provider, prompt) {
-    if (!prompt.trim()) {
-        throw new Error("Prompt is required");
+export function buildInteractiveAgentInvocation(provider, prompt, { resumeId } = {}) {
+    if (resumeId !== undefined && !SESSION_ID.test(resumeId)) {
+        throw new Error(`Invalid session id: ${String(resumeId)}`);
     }
+    // A resumed session carries its own history; an empty prompt must not be
+    // forwarded as an empty positional argument.
+    const trailing = prompt.trim() ? [prompt] : [];
     switch (provider) {
         case "claude":
-            return { shell: CLAUDE_BIN, args: [prompt] };
+            return {
+                shell: CLAUDE_BIN,
+                args: resumeId ? ["--resume", resumeId, ...trailing] : trailing,
+            };
         case "codex":
-            return { shell: CODEX_BIN, args: ["--no-alt-screen", prompt] };
+            return {
+                shell: CODEX_BIN,
+                args: resumeId
+                    ? ["--no-alt-screen", "resume", resumeId, ...trailing]
+                    : ["--no-alt-screen", ...trailing],
+            };
         default:
             throw new Error(`Unsupported agent provider: ${String(provider)}`);
     }

package/dist/core/agent-terminal.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-terminal.js","sourceRoot":"","sources":["../../src/core/agent-terminal.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,QAAQ,CAAC;AAChE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAS7D;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAAgB,EAChB,MAAc;IAEd,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,KAAK,OAAO;YACV,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAAE,CAAC;QACjE;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}
+{"version":3,"file":"agent-terminal.js","sourceRoot":"","sources":["../../src/core/agent-terminal.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,QAAQ,CAAC;AAChE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAc7D;;;;GAIG;AACH,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAAgB,EAChB,MAAc,EACd,EAAE,QAAQ,KAA8B,EAAE;IAE1C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,yEAAyE;IACzE,6CAA6C;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO;gBACL,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;aAChE,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,QAAQ;oBACZ,CAAC,CAAC,CAAC,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;oBACtD,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,QAAQ,CAAC;aACrC,CAAC;QACJ;YACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}

package/dist/core/agent-transcripts.d.ts

@@ -0,0 +1,27 @@
+export type TranscriptProvider = "claude" | "codex";
+export interface AgentTranscript {
+    /** Session id accepted by `claude --resume <id>` / `codex resume <id>`. */
+    id: string;
+    provider: TranscriptProvider;
+    /** Working directory the session ran in, read from the transcript body. */
+    cwd: string;
+    /** First real user prompt, used as the picker label. */
+    title: string;
+    startedAt: string;
+    /** File mtime — when the session was last written to. */
+    updatedAt: string;
+}
+export interface ListAgentTranscriptsOptions {
+    repoPath: string;
+    limit?: number;
+    /** Overridable for tests; defaults to the real home directory. */
+    homeDir?: string;
+    /** Overridable for tests and non-default Codex installations. */
+    codexHome?: string;
+}
+/**
+ * Prior Claude and Codex sessions recorded for `repoPath`, most recently
+ * written first. Metadata only — the transcript bodies are never surfaced,
+ * because resuming hands the conversation back to the CLI that rendered it.
+ */
+export declare function listAgentTranscripts(options: ListAgentTranscriptsOptions): Promise<AgentTranscript[]>;

package/dist/core/agent-transcripts.js

@@ -0,0 +1,240 @@
+import { createReadStream } from "node:fs";
+import { readdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+/**
+ * Both CLIs append newline-delimited JSON, so a session's identity, cwd and
+ * opening prompt all land in the first handful of lines. Transcripts run to
+ * megabytes, so every read stops as soon as those are in hand rather than
+ * parsing the whole conversation.
+ */
+const MAX_HEAD_LINES = 500;
+/** Upper bound on Codex rollout files opened per listing (they carry no path index). */
+const MAX_CODEX_SCAN = 400;
+/** Enough history for the dock picker to be useful without scanning unbounded metadata. */
+const DEFAULT_TRANSCRIPT_LIMIT = 100;
+const MAX_TITLE = 200;
+/**
+ * Claude encodes the cwd into a directory name lossily, and the encoding has
+ * changed between releases — `~/.claude/projects` currently holds both
+ * `...-Personal Project-brainctl` and `...-Personal-Project-brainctl`, and both
+ * `...-extension-3.0` and `...-extension-3-0`. Collapsing every non-alphanumeric
+ * run to a single `-` makes those variants compare equal, so one repo's history
+ * is found across all the directories past versions wrote it to. The comparison
+ * is deliberately lossy in the other direction too (sibling paths can collide),
+ * which is why every candidate file is confirmed against the `cwd` recorded in
+ * its own body before being returned.
+ */
+function pathKey(value) {
+    return value.replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-|-$/g, "").toLowerCase();
+}
+/** Reads leading lines as JSON, stopping when `onEntry` reports it has enough. */
+async function readHead(filePath, onEntry) {
+    const stream = createReadStream(filePath, { encoding: "utf8" });
+    const lines = createInterface({ input: stream, crlfDelay: Infinity });
+    let seen = 0;
+    try {
+        for await (const line of lines) {
+            if (++seen > MAX_HEAD_LINES)
+                break;
+            if (!line.trim())
+                continue;
+            let entry;
+            try {
+                entry = JSON.parse(line);
+            }
+            catch {
+                continue; // A truncated tail line must not discard the whole session.
+            }
+            if (entry && typeof entry === "object" && onEntry(entry))
+                break;
+        }
+    }
+    finally {
+        lines.close();
+        stream.destroy();
+    }
+}
+/**
+ * Injected context (environment blocks, slash-command expansions, system
+ * reminders) is recorded as a user turn by both CLIs, so anything opening with
+ * a tag is skipped in favour of the first prompt a human actually typed.
+ */
+function isTypedPrompt(text) {
+    const trimmed = text.trim();
+    return trimmed.length > 0
+        && !trimmed.startsWith("<")
+        && !trimmed.startsWith("# AGENTS.md instructions for ");
+}
+function toTitle(text) {
+    const collapsed = text.trim().replace(/\s+/g, " ");
+    return collapsed.length > MAX_TITLE ? `${collapsed.slice(0, MAX_TITLE - 1).trimEnd()}…` : collapsed;
+}
+/** Claude message content is either a plain string or an array of typed blocks. */
+function claudeText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((block) => (block && typeof block === "object" && typeof block.text === "string" ? block.text : ""))
+        .join("");
+}
+function codexText(content) {
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((block) => (block && typeof block === "object" && typeof block.text === "string" ? block.text : ""))
+        .join("");
+}
+async function readClaudeTranscript(filePath, fallbackId) {
+    let id;
+    let cwd;
+    let title;
+    let startedAt;
+    await readHead(filePath, (entry) => {
+        if (!id && typeof entry.sessionId === "string")
+            id = entry.sessionId;
+        if (!cwd && typeof entry.cwd === "string")
+            cwd = entry.cwd;
+        if (!startedAt && typeof entry.timestamp === "string")
+            startedAt = entry.timestamp;
+        if (!title && entry.type === "user" && entry.isSidechain !== true) {
+            const message = entry.message;
+            const text = claudeText(message && typeof message === "object" ? message.content : undefined);
+            if (isTypedPrompt(text))
+                title = toTitle(text);
+        }
+        return Boolean(cwd && title);
+    });
+    if (!cwd)
+        return null;
+    const { mtime } = await stat(filePath);
+    return {
+        id: id ?? fallbackId,
+        provider: "claude",
+        cwd,
+        title: title ?? "",
+        startedAt: startedAt ?? mtime.toISOString(),
+        updatedAt: mtime.toISOString(),
+    };
+}
+/**
+ * Codex records no per-project index, so a listing opens every recent rollout.
+ * `expectedCwd` lets a session that belongs to another project stop at its
+ * `session_meta` line instead of being read on in search of a prompt.
+ */
+async function readCodexTranscript(filePath, expectedCwd) {
+    let id;
+    let cwd;
+    let title;
+    let startedAt;
+    await readHead(filePath, (entry) => {
+        const payload = entry.payload;
+        if (!payload || typeof payload !== "object")
+            return false;
+        const body = payload;
+        if (entry.type === "session_meta") {
+            if (typeof body.session_id === "string")
+                id = body.session_id;
+            else if (typeof body.id === "string")
+                id = body.id;
+            if (typeof body.cwd === "string")
+                cwd = body.cwd;
+            if (typeof body.timestamp === "string")
+                startedAt = body.timestamp;
+            return cwd !== expectedCwd;
+        }
+        if (!title && body.type === "message" && body.role === "user") {
+            const text = codexText(body.content);
+            if (isTypedPrompt(text))
+                title = toTitle(text);
+        }
+        return Boolean(title);
+    });
+    if (!id || cwd !== expectedCwd)
+        return null;
+    const { mtime } = await stat(filePath);
+    return {
+        id,
+        provider: "codex",
+        cwd,
+        title: title ?? "",
+        startedAt: startedAt ?? mtime.toISOString(),
+        updatedAt: mtime.toISOString(),
+    };
+}
+async function listDir(path) {
+    try {
+        return await readdir(path);
+    }
+    catch {
+        return []; // A provider that was never installed simply contributes nothing.
+    }
+}
+async function claudeTranscripts(homeDir, repoPath) {
+    const root = join(homeDir, ".claude", "projects");
+    const key = pathKey(repoPath);
+    const dirs = (await listDir(root)).filter((name) => pathKey(name) === key);
+    const results = [];
+    for (const dir of dirs) {
+        const files = (await listDir(join(root, dir))).filter((name) => name.endsWith(".jsonl"));
+        for (const file of files) {
+            const transcript = await readClaudeTranscript(join(root, dir, file), file.replace(/\.jsonl$/, ""));
+            if (transcript && transcript.cwd === repoPath)
+                results.push(transcript);
+        }
+    }
+    return results;
+}
+/** Codex buckets rollouts by `sessions/YYYY/MM/DD`, so newest dates are walked first. */
+async function codexRolloutFiles(codexHome) {
+    const root = join(codexHome, "sessions");
+    const files = [];
+    const descending = (values) => values.sort((a, b) => b.localeCompare(a));
+    for (const year of descending(await listDir(root))) {
+        for (const month of descending(await listDir(join(root, year)))) {
+            for (const day of descending(await listDir(join(root, year, month)))) {
+                const dir = join(root, year, month, day);
+                for (const name of descending(await listDir(dir))) {
+                    if (name.startsWith("rollout-") && name.endsWith(".jsonl"))
+                        files.push(join(dir, name));
+                }
+                if (files.length >= MAX_CODEX_SCAN)
+                    return files;
+            }
+        }
+    }
+    return files;
+}
+async function codexTranscripts(codexHome, repoPath) {
+    const results = [];
+    for (const filePath of await codexRolloutFiles(codexHome)) {
+        const transcript = await readCodexTranscript(filePath, repoPath);
+        if (transcript)
+            results.push(transcript);
+    }
+    return results;
+}
+/**
+ * Prior Claude and Codex sessions recorded for `repoPath`, most recently
+ * written first. Metadata only — the transcript bodies are never surfaced,
+ * because resuming hands the conversation back to the CLI that rendered it.
+ */
+export async function listAgentTranscripts(options) {
+    const { repoPath, limit = DEFAULT_TRANSCRIPT_LIMIT } = options;
+    const homeDir = options.homeDir ?? homedir();
+    const codexHome = options.codexHome
+        ?? (options.homeDir ? join(homeDir, ".codex") : process.env.CODEX_HOME)
+        ?? join(homeDir, ".codex");
+    const [claude, codex] = await Promise.all([
+        claudeTranscripts(homeDir, repoPath),
+        codexTranscripts(codexHome, repoPath),
+    ]);
+    return [...claude, ...codex]
+        .filter((transcript) => transcript.title)
+        .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt))
+        .slice(0, limit);
+}
+//# sourceMappingURL=agent-transcripts.js.map

package/dist/core/agent-transcripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-transcripts.js","sourceRoot":"","sources":["../../src/core/agent-transcripts.ts"],"names":[],"mappings":"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"}

package/dist/core/config-store.d.ts

@@ -61,6 +61,15 @@ export declare class ConfigStore {
     private enqueueMutation;
     private mutateConfig;
     registerService(service: ServiceDefinition): Promise<NoMoreIdeConfig>;
+    /**
+     * Patches only the project assignment. Reassignment goes through here rather
+     * than `registerService` because that replaces the whole definition by name —
+     * a caller would have to resend every field, and any field it did not know
+     * about would be silently dropped.
+     *
+     * A blank or absent `projectPath` clears the assignment back to cwd inference.
+     */
+    setServiceProject(name: string, projectPath: string | undefined): Promise<NoMoreIdeConfig>;
     removeService(name: string): Promise<NoMoreIdeConfig>;
     registerBundle(bundle: BundleDefinition, previousName?: string): Promise<NoMoreIdeConfig>;
     registerGitRepository(repository: GitRepositoryDefinition): Promise<NoMoreIdeConfig>;
@@ -94,5 +103,14 @@ export declare class ConfigStore {
 export declare class ConfigValidationError extends Error {
 }
 export declare function isGitWorktree(path: string): Promise<boolean>;
+/**
+ * The worktree root enclosing `path`, or null when it is not inside a repo.
+ *
+ * Registering a service's own `cwd` is usually the wrong granularity — a service
+ * often runs from a subdirectory (`repo/frontend`), and a project pinned there
+ * would fight the path-based grouping. Resolving to the root first is what makes
+ * "adopt this service's folder" produce the project the user actually meant.
+ */
+export declare function gitToplevel(path: string): Promise<string | null>;
 /** @internal Deterministic stale-lock ownership seam used by regression tests. */
 export declare function __recoverStaleConfigLockForTests(lockPath: string, afterOwnerRead: () => void | Promise<void>): Promise<void>;

package/dist/core/config-store.js

@@ -20,6 +20,13 @@ const baseServiceSchema = z.object({
     test: z.string().min(1).optional(),
     /** Services that must be running/healthy before this one (bundle start order). */
     dependsOn: z.array(z.string().min(1)).optional(),
+    /**
+     * Explicit project assignment, overriding the cwd-containment inference.
+     * Needed because a remote service's `cwd` is a path on another machine
+     * (`/var/www/...`, `/root`) and can never sit under a local repo root, so
+     * inference alone leaves those services in no project at all.
+     */
+    projectPath: z.string().min(1).optional(),
 });
 const localServiceSchema = baseServiceSchema.extend({
     kind: z.literal("local").optional(),
@@ -282,6 +289,33 @@ export class ConfigStore {
             ];
         });
     }
+    /**
+     * Patches only the project assignment. Reassignment goes through here rather
+     * than `registerService` because that replaces the whole definition by name —
+     * a caller would have to resend every field, and any field it did not know
+     * about would be silently dropped.
+     *
+     * A blank or absent `projectPath` clears the assignment back to cwd inference.
+     */
+    async setServiceProject(name, projectPath) {
+        const serviceName = name.trim();
+        if (!serviceName) {
+            throw new ConfigValidationError("service name is required");
+        }
+        const assigned = projectPath?.trim();
+        return this.mutateConfig((config) => {
+            const service = config.services.find((item) => item.name === serviceName);
+            if (!service) {
+                throw new Error(`Service "${serviceName}" is not registered.`);
+            }
+            if (assigned) {
+                service.projectPath = assigned;
+            }
+            else {
+                delete service.projectPath;
+            }
+        });
+    }
     async removeService(name) {
         const serviceName = name.trim();
         if (!serviceName) {
@@ -472,6 +506,25 @@ export async function isGitWorktree(path) {
         return false;
     }
 }
+/**
+ * The worktree root enclosing `path`, or null when it is not inside a repo.
+ *
+ * Registering a service's own `cwd` is usually the wrong granularity — a service
+ * often runs from a subdirectory (`repo/frontend`), and a project pinned there
+ * would fight the path-based grouping. Resolving to the root first is what makes
+ * "adopt this service's folder" produce the project the user actually meant.
+ */
+export async function gitToplevel(path) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--show-toplevel"], {
+            cwd: path,
+        });
+        return stdout.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
 async function requireGitWorktree(path) {
     if (await isGitWorktree(path))
         return;