bet-cli 0.1.4 → 0.3.0

package/README.md

@@ -1,13 +1,3 @@
-```
-  ██
-  ██
-  ████████████
-             ██
-             ████████
-                    ╲╲
-                   ╲╲
-```
-
 # bet
 
 Keep your house in order. Explore and jump between local projects.
@@ -16,6 +6,27 @@ Keep your house in order. Explore and jump between local projects.
 
 If your `~/code` folder is chaos, **bet turns it into a map**.
 
+```
+
+                            ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░
+                        ░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░
+                    ░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░
+                ░░░░░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░
+            ░░░░░░░░░░░░░   ░░░░░   ░░░░░░                                 ░░░░░░
+        ░░░░░░░░░░░░░       ░░░░░   ░░░░░░                                 ░░░░░░
+      ░░░░░░░░░░░░          ░░░░░   ░░░░░░                                 ░░░░░░
+         ░░░░░░░░░░░░░░░░   ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+              ░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+                   ░░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░
+                        ░░░░░░░░░   ░░░░░░                                 ░░░░░░
+                            ░░░░░   ░░░░░░                                 ░░░░░░
+                            ░░░░░   ░░░░░░                                 ░░░░░░
+                            ░░░░░   ░░░░░░                                 ░░░░░░
+       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+
+```
+
 ## Why bet?
 
 - **No scrolling through 300 folders**
@@ -31,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
 
@@ -112,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).
 
@@ -121,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/ignore.js

@@ -30,7 +30,7 @@ export function registerIgnore(program) {
         }
         const rootPaths = config.roots.map((r) => r.path);
         if (!isPathUnderAnyRoot(normalized, rootPaths)) {
-            process.stderr.write(`Error: Path must be under a configured root.\n  Path: ${normalized}\n  Roots: ${rootPaths.join(", ")}\n`);
+            process.stderr.write(`Error: Path must be under a configured root. Use an absolute path (e.g. /path/to/project), not a project slug.\n  Path: ${normalized}\n  Roots: ${rootPaths.join(", ")}\n`);
             process.exitCode = 1;
             return;
         }

package/dist/commands/info.js

@@ -1,19 +1,20 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import chalk from "chalk";
-import { readConfig } from "../lib/config.js";
 import { render, Box, Text } from "ink";
+import { readConfig } from "../lib/config.js";
 import { findBySlug, listProjects, projectLabel } from "../lib/projects.js";
 import { getDirtyStatus, isInsideGitRepo } from "../lib/git.js";
 import { formatDate } from "../utils/format.js";
 import { promptSelect } from "../ui/prompt.js";
 import { readReadmeContent } from "../lib/readme.js";
-import Table from "../ui/table.js";
-const data = [];
+import Markdown from "../ui/markdown.js";
+const MetaRow = ({ label, value, valueColor }) => (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "gray", children: `${label}: ` }), _jsx(Text, { color: valueColor, bold: !!valueColor, children: value })] }));
 export function registerInfo(program) {
     program
         .command("info <slug>")
         .description("Show project details")
         .option("--json", "Print JSON output")
+        .option("--full", "Show full README content")
         .action(async (slug, options) => {
         const config = await readConfig();
         const projects = listProjects(config);
@@ -39,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;
@@ -54,18 +57,11 @@ export function registerInfo(program) {
         const hasGit = await isInsideGitRepo(project.path);
         const dirty = hasGit ? await getDirtyStatus(project.path) : undefined;
         if (process.stdin.isTTY) {
-            const readme = await readReadmeContent(project.path);
+            const readme = options.full
+                ? await readReadmeContent(project.path, { full: true })
+                : null;
             const markdown = readme ?? description;
-            let Markdown = null;
-            try {
-                const markdownModule = await import("ink-markdown");
-                Markdown = (markdownModule.default ??
-                    markdownModule);
-            }
-            catch {
-                Markdown = null;
-            }
-            const view = (_jsxs(Box, { flexDirection: "column", children: [_jsx(Table, { data: data }), _jsx(Text, { color: "green", bold: true, children: project.slug }), _jsx(Text, { dimColor: true, children: project.path }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, children: `Root: ${project.rootName}` }), _jsx(Text, { bold: true, children: `Root path: ${project.root}` }), _jsx(Text, { bold: true, children: `Git: ${hasGit ? "yes" : "no"}` }), _jsx(Text, { bold: true, children: `README: ${project.hasReadme ? "yes" : "no"}` }), _jsx(Text, { bold: true, children: `Started: ${formatDate(project.auto.startedAt)}` }), _jsx(Text, { bold: true, children: `Last modified: ${formatDate(project.auto.lastModifiedAt)}` }), _jsx(Text, { bold: true, children: `Last indexed: ${formatDate(project.auto.lastIndexedAt)}` }), _jsx(Text, { bold: true, children: `Dirty: ${dirty === undefined ? "unknown" : dirty ? "yes" : "no"}` }), project.user?.tags?.length ? (_jsx(Text, { children: `Tags: ${project.user.tags.join(", ")}` })) : null, project.user?.onEnter ? (_jsx(Text, { children: `On enter: ${project.user.onEnter}` })) : null] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { children: chalk.bold("Description") }), Markdown ? (_jsx(Markdown, { children: markdown })) : (_jsx(Text, { 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();
@@ -77,7 +73,11 @@ export function registerInfo(program) {
         process.stdout.write(`${chalk.bold("Root path:")} ${project.root}\n`);
         process.stdout.write(`${chalk.bold("Git:")} ${hasGit ? "yes" : "no"}\n`);
         process.stdout.write(`${chalk.bold("README:")} ${project.hasReadme ? "yes" : "no"}\n\n`);
-        process.stdout.write(`${chalk.bold("Description:")} ${description}\n`);
+        const descToShow = options.full && project.hasReadme
+            ? ((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`);
         process.stdout.write(`${chalk.bold("Last modified:")} ${formatDate(project.auto.lastModifiedAt)}\n`);
         process.stdout.write(`${chalk.bold("Last indexed:")} ${formatDate(project.auto.lastIndexedAt)}\n`);

package/dist/commands/list.js

@@ -1,11 +1,18 @@
-import chalk from 'chalk';
-import { readConfig } from '../lib/config.js';
-import path from 'node:path';
-import { listProjects } from '../lib/projects.js';
-import { emitSelection } from '../utils/output.js';
-import { promptSelect } from '../ui/prompt.js';
+import chalk from "chalk";
+import { readConfig } from "../lib/config.js";
+import path from "node:path";
+import { listProjects } from "../lib/projects.js";
+import { emitSelection } from "../utils/output.js";
+import { promptSelect } from "../ui/prompt.js";
 const MAX_ROWS = 18;
-const GROUP_COLORS = ['#22d3ee', '#34d399', '#facc15', '#c084fc', '#60a5fa', '#f87171'];
+const GROUP_COLORS = [
+    "#22d3ee",
+    "#34d399",
+    "#facc15",
+    "#c084fc",
+    "#60a5fa",
+    "#f87171",
+];
 function groupColor(index) {
     return GROUP_COLORS[index % GROUP_COLORS.length];
 }
@@ -44,22 +51,23 @@ function orderedGroupsByConfigRoots(projects, roots) {
 }
 export function registerList(program) {
     program
-        .command('list')
-        .description('List projects')
-        .option('--plain', 'Print a non-interactive list')
-        .option('--json', 'Print JSON output')
-        .option('--print', 'Print selected path only')
+        .command("list")
+        .alias("ls")
+        .description("List projects")
+        .option("--plain", "Print a non-interactive list")
+        .option("--json", "Print JSON output")
+        .option("--print", "Print selected path only")
         .action(async (options) => {
         const config = await readConfig();
         const projects = listProjects(config);
         if (options.json) {
             process.stdout.write(JSON.stringify(projects, null, 2));
-            process.stdout.write('\n');
+            process.stdout.write("\n");
             return;
         }
         if (!process.stdin.isTTY || options.plain) {
             if (projects.length === 0) {
-                process.stdout.write('No projects indexed. Run bet update.\n');
+                process.stdout.write("No projects indexed. Run bet update.\n");
                 return;
             }
             const orderedGroups = orderedGroupsByConfigRoots(projects, config.roots);
@@ -79,17 +87,24 @@ export function registerList(program) {
         const rows = [];
         let groupIndex = 0;
         for (const { rootName, items } of orderedGroups) {
-            rows.push({ type: 'group', label: rootName, color: groupColor(groupIndex++) });
+            rows.push({
+                type: "group",
+                label: rootName,
+                color: groupColor(groupIndex++),
+            });
             for (const project of items) {
                 const rel = relativePath(project.path, project.root);
                 rows.push({
-                    type: 'item',
+                    type: "item",
                     label: formatLabel(project.slug, project.rootName, rel),
                     value: project,
                 });
             }
         }
-        const selected = await promptSelect(rows, { title: 'Projects', maxRows: MAX_ROWS });
+        const selected = await promptSelect(rows, {
+            title: "Projects",
+            maxRows: MAX_ROWS,
+        });
         if (!selected)
             return;
         emitSelection(selected.value, { printOnly: options.print });

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) => {
@@ -134,9 +136,14 @@ export function registerUpdate(program) {
                 version: config.version ?? 1,
                 roots: rootsResolved,
                 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/index.js

@@ -1,30 +1,9 @@
 #!/usr/bin/env node
-import { Command } from "commander";
-import { GroupedHelp } from "./lib/help.js";
-import { registerUpdate } from "./commands/update.js";
-import { registerList } from "./commands/list.js";
-import { registerSearch } from "./commands/search.js";
-import { registerInfo } from "./commands/info.js";
-import { registerGo } from "./commands/go.js";
-import { registerPath } from "./commands/path.js";
-import { registerShell } from "./commands/shell.js";
-import { registerCompletion } from "./commands/completion.js";
-import { registerIgnore } from "./commands/ignore.js";
-const program = new Command();
-program.createHelp = function createHelp() {
-    return Object.assign(new GroupedHelp(), this.configureHelp());
-};
-program
-    .name("bet")
-    .description("Explore and jump between local projects.")
-    .version("0.1.3");
-registerUpdate(program);
-registerList(program);
-registerSearch(program);
-registerInfo(program);
-registerGo(program);
-registerPath(program);
-registerShell(program);
-registerCompletion(program);
-registerIgnore(program);
-program.parseAsync(process.argv);
+/**
+ * Set FORCE_COLOR before any module (including Ink/chalk) is loaded so that
+ * list/search/info render with colors. ESM hoists static imports, so we must
+ * use a dynamic import here.
+ */
+process.env.FORCE_COLOR = "1";
+await import("./main.js");
+export {};

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 }),
@@ -87,6 +95,7 @@ async function readProjectsConfig() {
         const parsed = JSON.parse(raw);
         return {
             projects: parsed.projects ?? {},
+            ...(parsed.updatedAt != null && typeof parsed.updatedAt === "string" && { updatedAt: parsed.updatedAt }),
         };
     }
     catch (error) {
@@ -116,6 +125,7 @@ export async function readConfig() {
     return {
         ...appConfig,
         projects: normalizedProjects,
+        ...(projectsConfig.updatedAt != null && { updatedAt: projectsConfig.updatedAt }),
     };
 }
 async function writeAppConfig(appConfig) {
@@ -132,12 +142,14 @@ 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 }),
     };
     const projectsConfig = {
         projects: config.projects,
+        ...(config.updatedAt !== undefined && { updatedAt: config.updatedAt }),
     };
     await Promise.all([
         writeAppConfig(appConfig),

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/lib/readme.js

@@ -14,14 +14,17 @@ export async function readReadmePath(projectPath) {
     }
     return undefined;
 }
-export async function readReadmeContent(projectPath) {
+export async function readReadmeContent(projectPath, options) {
     const readmePath = await readReadmePath(projectPath);
     if (!readmePath)
         return undefined;
     let content = await fs.readFile(readmePath, "utf8");
     // remove html tags
     content = content.replace(/<[^>]*>?/g, "");
-    // only graph the first 300 characters, and add ... if there are more
+    if (options?.full) {
+        return content;
+    }
+    // only grab the first 500 characters, and add ... if there are more
     const truncated = content.slice(0, 500);
     if (content.length > 500) {
         return `${truncated}...`;