bet-cli 0.2.0 → 0.3.0

package/README.md

@@ -42,6 +42,7 @@ If your `~/code` folder is chaos, **bet turns it into a map**.
 - `bet update` scans those roots and builds an index.
 - Projects are detected using simple signals (today: folders containing **`.git`** and/or a **`README.md`**, with common build dirs ignored).
 - Commands like `list`, `search`, `info`, `path`, and `go` read that index.
+- Commands like `list`, `search`, `info`, `path`, `go`, and `edit` read that index.
 
 ## Install
 
@@ -123,6 +124,9 @@ Then Tab-complete the slug argument after `bet go `, `bet path `, or `bet info `
 - **`bet go <slug>`**: Jump to a project.
   - **`--print`**: print selected path only (no shell `cd`)
   - **`--no-enter`**: do not run the project’s `onEnter` hook (if configured)
+- **`bet edit <slug>`**: Open a project in your editor.
+  - Uses `editor` from `config.json` when set.
+  - Falls back to the system default app opener when `editor` is not set.
 - **`bet shell`**: Print the shell integration snippet (see above).
 - **`bet completion [bash|zsh]`**: Print shell completion script for project name autocompletion (see above).
 
@@ -132,6 +136,7 @@ bet stores its data in:
 
 - **Config dir**: `~/.config/bet/` (or `$XDG_CONFIG_HOME/bet/`)
 - **Roots**: `config.json` — each root is `{ "path": "/absolute/path", "name": "display-name" }`. The name defaults to the top folder name and is used when listing/grouping projects.
+- **editor** (optional): In `config.json`, a command string used by `bet edit`, for example `"code -n"` or `"cursor"`.
 - **slugParentFolders** (optional): In `config.json`, an array of folder names. When a discovered project path ends in one of these (e.g. `src` or `app`), the project slug is taken from the parent directory name instead. Default in code is `["src", "app"]` when the key is not set.
 - **Project index**: `projects.json`
 

package/dist/commands/edit.js

@@ -0,0 +1,48 @@
+import { readConfig } from "../lib/config.js";
+import { openProjectInEditor } from "../lib/editor.js";
+import { findBySlug, listProjects, projectLabel } from "../lib/projects.js";
+import { promptSelect } from "../ui/prompt.js";
+export function registerEdit(program) {
+    program
+        .command("edit <slug>")
+        .description("Open a project in your editor")
+        .action(async (slug) => {
+        try {
+            const config = await readConfig();
+            const projects = listProjects(config);
+            const matches = findBySlug(projects, slug);
+            if (matches.length === 0) {
+                process.stderr.write(`No project found for slug "${slug}".\n`);
+                process.exitCode = 1;
+                return;
+            }
+            let project = matches[0];
+            if (matches.length > 1) {
+                if (!process.stdin.isTTY) {
+                    process.stderr.write(`Slug "${slug}" is ambiguous. Matches:\n`);
+                    for (const item of matches) {
+                        process.stderr.write(`  ${projectLabel(item)} ${item.path}\n`);
+                    }
+                    process.exitCode = 1;
+                    return;
+                }
+                const items = matches.map((item) => ({
+                    label: projectLabel(item),
+                    hint: item.path,
+                    value: item,
+                    type: "item",
+                }));
+                const selected = await promptSelect(items, { title: `Select ${slug}` });
+                if (!selected)
+                    return;
+                project = selected.value;
+            }
+            await openProjectInEditor(project.path, config.editor);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`Error: ${message}\n`);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/commands/info.js

@@ -40,7 +40,9 @@ export function registerInfo(program) {
                 value: item,
                 type: "item",
             }));
-            const selected = await promptSelect(items, { title: `Select ${slug}` });
+            const selected = await promptSelect(items, {
+                title: `Select ${slug}`,
+            });
             if (!selected)
                 return;
             project = selected.value;
@@ -59,7 +61,7 @@ export function registerInfo(program) {
                 ? await readReadmeContent(project.path, { full: true })
                 : null;
             const markdown = readme ?? description;
-            const view = (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsxs(Box, { width: "100%", borderStyle: "single", borderColor: "green", paddingX: 1, paddingY: 1, marginBottom: 1, children: [_jsx(Text, { color: "green", bold: true, children: project.slug }), _jsx(Text, { color: "cyan", children: project.path })] }), _jsxs(Box, { borderStyle: "round", borderColor: "cyan", padding: 1, flexDirection: "column", marginBottom: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "magenta", children: "Details" }) }), _jsxs(Box, { flexDirection: "column", children: [_jsx(MetaRow, { label: "Root", value: project.rootName }), _jsx(MetaRow, { label: "Root path", value: project.root }), _jsx(MetaRow, { label: "Git", value: hasGit ? "yes" : "no", valueColor: hasGit ? "green" : "yellow" }), _jsx(MetaRow, { label: "README", value: project.hasReadme ? "yes" : "no", valueColor: project.hasReadme ? "green" : "yellow" }), _jsx(MetaRow, { label: "Started", value: formatDate(project.auto.startedAt) }), _jsx(MetaRow, { label: "Last modified", value: formatDate(project.auto.lastModifiedAt) }), _jsx(MetaRow, { label: "Last indexed", value: formatDate(project.auto.lastIndexedAt) }), _jsx(MetaRow, { label: "Dirty", value: dirty === undefined ? "unknown" : dirty ? "yes" : "no", valueColor: dirty === undefined ? "yellow" : dirty ? "red" : "green" }), project.user?.tags?.length ? (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "gray", children: `Tags: ` }), _jsx(Text, { color: "magenta", children: project.user.tags.join(", ") })] })) : null, project.user?.onEnter ? (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "gray", children: `On enter: ` }), _jsx(Text, { color: "blue", children: project.user.onEnter })] })) : null] })] }), _jsxs(Box, { borderStyle: "round", borderColor: "magenta", padding: 1, flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "magenta", children: "Description" }) }), _jsx(Markdown, { children: markdown })] })] }));
+            const view = (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsxs(Box, { width: "100%", borderStyle: "single", borderColor: "green", paddingX: 1, paddingY: 1, marginBottom: 1, flexDirection: "column", children: [_jsx(Box, { width: "100%", paddingBottom: 1, children: _jsx(Text, { color: "green", bold: true, children: project.slug }) }), _jsx(Box, { width: "100%", children: _jsx(Text, { color: "cyan", children: project.path }) })] }), _jsxs(Box, { borderStyle: "round", borderColor: "cyan", padding: 1, flexDirection: "column", marginBottom: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "magenta", children: "Details" }) }), _jsxs(Box, { flexDirection: "column", children: [_jsx(MetaRow, { label: "Git", value: hasGit ? "yes" : "no", valueColor: hasGit ? "green" : "yellow" }), _jsx(MetaRow, { label: "Git dirty", value: dirty === undefined ? "unknown" : dirty ? "yes" : "no", valueColor: dirty === undefined ? "yellow" : dirty ? "red" : "green" }), _jsx(MetaRow, { label: "README", value: project.hasReadme ? "yes" : "no", valueColor: project.hasReadme ? "green" : "yellow" }), _jsx(MetaRow, { label: "Started", value: formatDate(project.auto.startedAt) }), _jsx(MetaRow, { label: "Last modified", value: formatDate(project.auto.lastModifiedAt) }), _jsx(MetaRow, { label: "Last indexed", value: formatDate(project.auto.lastIndexedAt) }), _jsx(MetaRow, { label: "Root", value: project.rootName }), _jsx(MetaRow, { label: "Root path", value: project.root }), project.user?.tags?.length ? (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "gray", children: `Tags: ` }), _jsx(Text, { color: "magenta", children: project.user.tags.join(", ") })] })) : null, project.user?.onEnter ? (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "gray", children: `On enter: ` }), _jsx(Text, { color: "blue", children: project.user.onEnter })] })) : null] })] }), _jsxs(Box, { borderStyle: "round", borderColor: "magenta", padding: 1, flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "magenta", children: "Description" }) }), _jsx(Markdown, { children: markdown })] }), !options.full && project.hasReadme ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: ["Tip: Run ", _jsxs(Text, { bold: true, children: ["bet info ", project.slug, " --full"] }), " to read the full README."] }) })) : null] }));
             const { unmount } = render(view, { stdout: process.stdout });
             await new Promise((resolve) => setTimeout(resolve, 0));
             unmount();
@@ -72,7 +74,8 @@ export function registerInfo(program) {
         process.stdout.write(`${chalk.bold("Git:")} ${hasGit ? "yes" : "no"}\n`);
         process.stdout.write(`${chalk.bold("README:")} ${project.hasReadme ? "yes" : "no"}\n\n`);
         const descToShow = options.full && project.hasReadme
-            ? (await readReadmeContent(project.path, { full: true })) ?? description
+            ? ((await readReadmeContent(project.path, { full: true })) ??
+                description)
             : description;
         process.stdout.write(`${chalk.bold("Description:")} ${descToShow}\n`);
         process.stdout.write(`${chalk.bold("Started:")} ${formatDate(project.auto.startedAt)}\n`);

package/dist/commands/update.js

@@ -2,7 +2,7 @@ import path from "node:path";
 import readline from "node:readline";
 import { readConfig, resolveRoots, writeConfig } from "../lib/config.js";
 import { normalizeAbsolute } from "../utils/paths.js";
-import { installUpdateCron, uninstallUpdateCron, parseCronSchedule, formatScheduleLabel } from "../lib/cron.js";
+import { installUpdateCron, uninstallUpdateCron, parseCronSchedule, formatScheduleLabel, } from "../lib/cron.js";
 import { scanRoots } from "../lib/scan.js";
 import { computeMetadata } from "../lib/metadata.js";
 import { getEffectiveIgnores, isPathIgnored } from "../lib/ignore.js";
@@ -23,8 +23,7 @@ function pathsToRootConfigs(paths) {
     });
 }
 export function willOverrideRoots(providedRootConfigs, configRoots) {
-    return !!(providedRootConfigs !== undefined &&
-        configRoots.length > 0);
+    return !!(providedRootConfigs !== undefined && configRoots.length > 0);
 }
 const DEFAULT_SLUG_PARENT_FOLDERS = ["src", "app"];
 export { DEFAULT_SLUG_PARENT_FOLDERS };
@@ -36,7 +35,10 @@ export function projectSlug(pathName, slugParentFolders) {
     return folderName;
 }
 async function promptYesNo(question, defaultNo = true) {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stderr,
+    });
     return new Promise((resolve) => {
         const defaultHint = defaultNo ? "y/N" : "Y/n";
         rl.question(question + " [" + defaultHint + "] ", (answer) => {
@@ -136,8 +138,12 @@ export function registerUpdate(program) {
                 projects,
                 updatedAt: new Date().toISOString(),
                 ...(config.ignores !== undefined && { ignores: config.ignores }),
-                ...(config.ignoredPaths !== undefined && { ignoredPaths: config.ignoredPaths }),
-                ...(config.slugParentFolders !== undefined && { slugParentFolders: config.slugParentFolders }),
+                ...(config.ignoredPaths !== undefined && {
+                    ignoredPaths: config.ignoredPaths,
+                }),
+                ...(config.slugParentFolders !== undefined && {
+                    slugParentFolders: config.slugParentFolders,
+                }),
             };
             await writeConfig(nextConfig);
             const projectCount = Object.keys(projects).length;

package/dist/lib/config.js

@@ -60,11 +60,18 @@ function normalizeIgnoredPaths(parsed) {
     const list = parsed.filter((x) => typeof x === "string").map((x) => normalizeAbsolute(x));
     return list.length === 0 ? undefined : list;
 }
+function normalizeEditor(parsed) {
+    if (typeof parsed !== "string")
+        return undefined;
+    const trimmed = parsed.trim();
+    return trimmed.length === 0 ? undefined : trimmed;
+}
 async function readAppConfig() {
     try {
         const raw = await fs.readFile(CONFIG_PATH, "utf8");
         const parsed = JSON.parse(raw);
         const roots = normalizeRoots(parsed.roots ?? []);
+        const editor = normalizeEditor(parsed.editor);
         const ignores = normalizeIgnores(parsed.ignores);
         const ignoredPaths = normalizeIgnoredPaths(parsed.ignoredPaths);
         const slugParentFolders = normalizeSlugParentFolders(parsed.slugParentFolders);
@@ -72,6 +79,7 @@ async function readAppConfig() {
             ...DEFAULT_APP_CONFIG,
             version: parsed.version ?? 1,
             roots,
+            ...(editor !== undefined && { editor }),
             ...(ignores !== undefined && { ignores }),
             ...(ignoredPaths !== undefined && { ignoredPaths }),
             ...(slugParentFolders !== undefined && { slugParentFolders }),
@@ -134,6 +142,7 @@ export async function writeConfig(config) {
     const appConfig = {
         version: config.version,
         roots: config.roots,
+        ...(config.editor !== undefined && { editor: config.editor }),
         ...(config.ignores !== undefined && { ignores: config.ignores }),
         ...(config.ignoredPaths !== undefined && { ignoredPaths: config.ignoredPaths }),
         ...(config.slugParentFolders !== undefined && { slugParentFolders: config.slugParentFolders }),

package/dist/lib/editor.js

@@ -0,0 +1,97 @@
+import { spawn } from "node:child_process";
+function tokenizeCommand(input) {
+    const tokens = [];
+    let current = "";
+    let inSingle = false;
+    let inDouble = false;
+    let escaped = false;
+    for (const char of input) {
+        if (escaped) {
+            current += char;
+            escaped = false;
+            continue;
+        }
+        if (char === "\\") {
+            escaped = true;
+            continue;
+        }
+        if (char === "'" && !inDouble) {
+            inSingle = !inSingle;
+            continue;
+        }
+        if (char === '"' && !inSingle) {
+            inDouble = !inDouble;
+            continue;
+        }
+        if (!inSingle && !inDouble && /\s/.test(char)) {
+            if (current.length > 0) {
+                tokens.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (escaped || inSingle || inDouble) {
+        throw new Error("Invalid editor command in config.");
+    }
+    if (current.length > 0) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+export function parseEditorCommand(editor) {
+    const trimmed = editor.trim();
+    if (!trimmed) {
+        throw new Error("Config editor must not be empty.");
+    }
+    const tokens = tokenizeCommand(trimmed);
+    if (tokens.length === 0) {
+        throw new Error("Config editor must not be empty.");
+    }
+    const [command, ...args] = tokens;
+    return { command, args };
+}
+export function getSystemOpenCommand(targetPath, platform = process.platform) {
+    if (platform === "darwin") {
+        return { command: "open", args: [targetPath] };
+    }
+    if (platform === "win32") {
+        return { command: "cmd", args: ["/c", "start", "", targetPath] };
+    }
+    return { command: "xdg-open", args: [targetPath] };
+}
+function getEnvEditor(env) {
+    const visual = env.VISUAL?.trim();
+    if (visual)
+        return visual;
+    const editor = env.EDITOR?.trim();
+    if (editor)
+        return editor;
+    return undefined;
+}
+function spawnDetached(command, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            detached: true,
+            stdio: "ignore",
+        });
+        child.once("error", (error) => {
+            reject(error);
+        });
+        child.once("spawn", () => {
+            child.unref();
+            resolve();
+        });
+    });
+}
+export async function openProjectInEditor(projectPath, configuredEditor, env = process.env) {
+    const preferredEditor = configuredEditor?.trim() || getEnvEditor(env);
+    if (preferredEditor) {
+        const parsed = parseEditorCommand(preferredEditor);
+        await spawnDetached(parsed.command, [...parsed.args, projectPath]);
+        return;
+    }
+    const fallback = getSystemOpenCommand(projectPath);
+    await spawnDetached(fallback.command, fallback.args);
+}

package/dist/lib/git.js

@@ -1,10 +1,10 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
 async function runGit(cwd, args) {
     try {
-        const { stdout } = await execFileAsync('git', ['-C', cwd, ...args], {
-            encoding: 'utf8',
+        const { stdout } = await execFileAsync("git", ["-C", cwd, ...args], {
+            encoding: "utf8",
         });
         return stdout.trim();
     }
@@ -13,16 +13,22 @@ async function runGit(cwd, args) {
     }
 }
 export async function getFirstCommitDate(cwd) {
-    const output = await runGit(cwd, ['log', '--reverse', '--format=%cI', '-n', '1']);
+    const output = await runGit(cwd, [
+        "log",
+        "--max-parents=0",
+        "--format=%cd",
+        "--date=iso-strict",
+        "HEAD",
+    ]);
     return output || undefined;
 }
 export async function getDirtyStatus(cwd) {
-    const output = await runGit(cwd, ['status', '--porcelain']);
+    const output = await runGit(cwd, ["status", "--porcelain"]);
     if (output === null)
         return undefined;
     return output.length > 0;
 }
 export async function isInsideGitRepo(cwd) {
-    const output = await runGit(cwd, ['rev-parse', '--is-inside-work-tree']);
-    return output === 'true';
+    const output = await runGit(cwd, ["rev-parse", "--is-inside-work-tree"]);
+    return output === "true";
 }

package/dist/lib/help.js

@@ -1,5 +1,5 @@
 import { Help } from "commander";
-const GROUP_1 = ["list", "search", "info", "go", "path"];
+const GROUP_1 = ["list", "search", "info", "go", "edit", "path"];
 const GROUP_2 = ["shell", "completion"];
 const GROUP_3 = ["update", "ignore", "help"];
 const GROUPS = [
@@ -40,12 +40,16 @@ export class GroupedHelp extends Help {
             output.push(helper.wrap(commandDescription, helpWidth, 0), "");
         }
         // Arguments
-        const argumentList = helper.visibleArguments(cmd).map((argument) => formatItem(helper.argumentTerm(argument), helper.argumentDescription(argument)));
+        const argumentList = helper
+            .visibleArguments(cmd)
+            .map((argument) => formatItem(helper.argumentTerm(argument), helper.argumentDescription(argument)));
         if (argumentList.length > 0) {
             output.push("Arguments:", formatList(argumentList), "");
         }
         // Options
-        const optionList = helper.visibleOptions(cmd).map((option) => formatItem(helper.optionTerm(option), helper.optionDescription(option)));
+        const optionList = helper
+            .visibleOptions(cmd)
+            .map((option) => formatItem(helper.optionTerm(option), helper.optionDescription(option)));
         if (optionList.length > 0) {
             output.push("Options:", formatList(optionList), "");
         }

package/dist/main.js

@@ -9,23 +9,24 @@ import { registerPath } from "./commands/path.js";
 import { registerShell } from "./commands/shell.js";
 import { registerCompletion } from "./commands/completion.js";
 import { registerIgnore } from "./commands/ignore.js";
+import { registerEdit } from "./commands/edit.js";
 const ASCII_HEADER = `
                             ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░
                         ░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░
-                    ░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░          
-                ░░░░░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░          
-            ░░░░░░░░░░░░░   ░░░░░   ░░░░░░                                 ░░░░░░          
-        ░░░░░░░░░░░░░       ░░░░░   ░░░░░░                                 ░░░░░░          
-      ░░░░░░░░░░░░          ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
-         ░░░░░░░░░░░░░░░░   ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
-              ░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
-                   ░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
-                        ░░░░░░░░░   ░░░░░░                                 ░░░░░░          
-                            ░░░░░   ░░░░░░                                 ░░░░░░          
-                            ░░░░░   ░░░░░░                                 ░░░░░░          
-                            ░░░░░   ░░░░░░                                 ░░░░░░          
-       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
-       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
+                    ░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░
+                ░░░░░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░
+            ░░░░░░░░░░░░░   ░░░░░   ░░░░░░                                 ░░░░░░
+        ░░░░░░░░░░░░░       ░░░░░   ░░░░░░                                 ░░░░░░
+      ░░░░░░░░░░░░          ░░░░░   ░░░░░░                                 ░░░░░░
+         ░░░░░░░░░░░░░░░░   ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+              ░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+                   ░░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░
+                        ░░░░░░░░░   ░░░░░░                                 ░░░░░░
+                            ░░░░░   ░░░░░░                                 ░░░░░░
+                            ░░░░░   ░░░░░░                                 ░░░░░░
+                            ░░░░░   ░░░░░░                                 ░░░░░░
+       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
 `;
 const program = new Command();
 program.createHelp = function createHelp() {
@@ -40,6 +41,7 @@ registerList(program);
 registerSearch(program);
 registerInfo(program);
 registerGo(program);
+registerEdit(program);
 registerPath(program);
 registerShell(program);
 registerCompletion(program);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bet-cli",
   "description": "Explore and jump between local projects.",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "author": "Chris Mckenzie",
   "license": "Apache-2.0",
   "repository": {

package/src/commands/edit.ts

@@ -0,0 +1,56 @@
+import { Command } from "commander";
+import { readConfig } from "../lib/config.js";
+import { openProjectInEditor } from "../lib/editor.js";
+import { findBySlug, listProjects, projectLabel } from "../lib/projects.js";
+import { promptSelect } from "../ui/prompt.js";
+import { SelectEntry } from "../ui/select.js";
+
+export function registerEdit(program: Command): void {
+  program
+    .command("edit <slug>")
+    .description("Open a project in your editor")
+    .action(async (slug: string) => {
+      try {
+        const config = await readConfig();
+        const projects = listProjects(config);
+        const matches = findBySlug(projects, slug);
+
+        if (matches.length === 0) {
+          process.stderr.write(`No project found for slug "${slug}".\n`);
+          process.exitCode = 1;
+          return;
+        }
+
+        let project = matches[0];
+        if (matches.length > 1) {
+          if (!process.stdin.isTTY) {
+            process.stderr.write(`Slug "${slug}" is ambiguous. Matches:\n`);
+            for (const item of matches) {
+              process.stderr.write(`  ${projectLabel(item)} ${item.path}\n`);
+            }
+            process.exitCode = 1;
+            return;
+          }
+
+          const items: SelectEntry<(typeof matches)[number]>[] = matches.map(
+            (item) => ({
+              label: projectLabel(item),
+              hint: item.path,
+              value: item,
+              type: "item",
+            }),
+          );
+
+          const selected = await promptSelect(items, { title: `Select ${slug}` });
+          if (!selected) return;
+          project = selected.value;
+        }
+
+        await openProjectInEditor(project.path, config.editor);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`Error: ${message}\n`);
+        process.exitCode = 1;
+      }
+    });
+}