bet-cli 0.1.4 → 0.2.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**

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);
@@ -54,18 +55,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, 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 { unmount } = render(view, { stdout: process.stdout });
             await new Promise((resolve) => setTimeout(resolve, 0));
             unmount();
@@ -77,7 +71,10 @@ 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

@@ -134,6 +134,7 @@ 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 }),

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

@@ -87,6 +87,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 +117,7 @@ export async function readConfig() {
     return {
         ...appConfig,
         projects: normalizedProjects,
+        ...(projectsConfig.updatedAt != null && { updatedAt: projectsConfig.updatedAt }),
     };
 }
 async function writeAppConfig(appConfig) {
@@ -138,6 +140,7 @@ export async function writeConfig(config) {
     };
     const projectsConfig = {
         projects: config.projects,
+        ...(config.updatedAt !== undefined && { updatedAt: config.updatedAt }),
     };
     await Promise.all([
         writeAppConfig(appConfig),

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}...`;

package/dist/main.js

@@ -0,0 +1,48 @@
+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 ASCII_HEADER = `
+                            ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░
+                        ░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░
+                    ░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░          
+                ░░░░░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░          
+            ░░░░░░░░░░░░░   ░░░░░   ░░░░░░                                 ░░░░░░          
+        ░░░░░░░░░░░░░       ░░░░░   ░░░░░░                                 ░░░░░░          
+      ░░░░░░░░░░░░          ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
+         ░░░░░░░░░░░░░░░░   ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
+              ░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
+                   ░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
+                        ░░░░░░░░░   ░░░░░░                                 ░░░░░░          
+                            ░░░░░   ░░░░░░                                 ░░░░░░          
+                            ░░░░░   ░░░░░░                                 ░░░░░░          
+                            ░░░░░   ░░░░░░                                 ░░░░░░          
+       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
+       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░          
+`;
+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.2.0");
+registerUpdate(program);
+registerList(program);
+registerSearch(program);
+registerInfo(program);
+registerGo(program);
+registerPath(program);
+registerShell(program);
+registerCompletion(program);
+registerIgnore(program);
+program.addHelpText("before", ASCII_HEADER);
+program.parseAsync(process.argv);

package/dist/ui/markdown.js

@@ -1,10 +1,9 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Text } from 'ink';
-import { marked } from 'marked';
-import TerminalRenderer from 'marked-terminal';
-const renderer = new TerminalRenderer();
-export function Markdown({ content }) {
-    marked.setOptions({ renderer });
-    const output = marked.parse(content).trim();
-    return _jsx(Text, { children: output });
+import { Text } from "ink";
+import { marked } from "marked";
+import { markedTerminal } from "marked-terminal";
+import React from "react";
+export default function Markdown({ children, ...options }) {
+    marked.use(markedTerminal(options));
+    const parsedMarkdown = marked.parse(children, { async: false });
+    return React.createElement(Text, null, parsedMarkdown.trim());
 }

package/dist/ui/search.js

@@ -1,6 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useMemo, useState } from 'react';
-import chalk from 'chalk';
 import { Box, Text, useInput } from 'ink';
 const DEFAULT_MAX_ROWS = 18;
 export function SearchSelect({ title, allItems, filter, onSelect, onCancel, maxRows = DEFAULT_MAX_ROWS, initialQuery = '', showCount = true, }) {
@@ -37,7 +36,7 @@ export function SearchSelect({ title, allItems, filter, onSelect, onCancel, maxR
         }
     });
     if (items.length === 0) {
-        return (_jsxs(Box, { flexDirection: "column", children: [title && _jsx(Text, { children: chalk.bold(title) }), _jsx(Text, { children: `Search: ${query}` }), _jsx(Text, { children: "No results." })] }));
+        return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", padding: 1, children: [title ? (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: title }) })) : null, _jsxs(Box, { marginBottom: 1, flexDirection: "row", children: [_jsx(Text, { bold: true, color: "yellow", children: "Search: " }), _jsx(Text, { color: "cyan", children: query || '…' })] }), _jsx(Text, { color: "yellow", children: "No results." }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "Press Esc to exit." }) })] }));
     }
     const selectedRowIndex = Math.min(cursor, items.length - 1);
     const totalRows = items.length;
@@ -45,9 +44,9 @@ export function SearchSelect({ title, allItems, filter, onSelect, onCancel, maxR
     const windowStart = Math.min(Math.max(0, selectedRowIndex - Math.floor(effectiveMaxRows / 2)), Math.max(0, totalRows - effectiveMaxRows));
     const windowEnd = Math.min(totalRows, windowStart + effectiveMaxRows);
     const windowed = items.slice(windowStart, windowEnd);
-    return (_jsxs(Box, { flexDirection: "column", children: [title && _jsx(Text, { children: chalk.bold(title) }), _jsx(Text, { children: `Search: ${query}` }), showCount && _jsx(Text, { children: chalk.dim(`${items.length} result(s)`) }), windowed.map((row, idx) => {
-                const absoluteIndex = windowStart + idx;
-                const selected = absoluteIndex === selectedRowIndex;
-                return (_jsxs(Box, { children: [_jsxs(Text, { children: [selected ? chalk.cyan.bold('› ') : '  ', selected ? chalk.cyan.bold(row.label) : row.label] }), row.hint ? _jsx(Text, { children: chalk.dim(` ${row.hint}`) }) : null] }, `item-${absoluteIndex}`));
-            }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: chalk.dim('Type to filter. Use ↑/↓ or j/k. Enter to select. Esc to cancel.') }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", padding: 1, children: [title ? (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: title }) })) : null, _jsxs(Box, { marginBottom: 1, flexDirection: "row", children: [_jsx(Text, { bold: true, color: "yellow", children: "Search: " }), _jsx(Text, { color: "green", children: query || '…' }), showCount ? (_jsxs(Text, { color: "cyan", children: [" \u00B7 ", items.length, " result", items.length !== 1 ? 's' : ''] })) : null] }), _jsx(Box, { flexDirection: "column", children: windowed.map((row, idx) => {
+                    const absoluteIndex = windowStart + idx;
+                    const selected = absoluteIndex === selectedRowIndex;
+                    return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: selected ? 'green' : undefined, bold: selected, children: [selected ? '› ' : '  ', row.label] }), row.hint ? _jsxs(Text, { color: "gray", children: [" ", row.hint] }) : null] }, `item-${absoluteIndex}`));
+                }) }), _jsxs(Box, { marginTop: 1, flexDirection: "row", children: [_jsx(Text, { color: "yellow", children: "Type to filter" }), _jsx(Text, { color: "gray", children: " \u00B7 " }), _jsx(Text, { color: "yellow", children: "\u2191/\u2193 or j/k" }), _jsx(Text, { color: "gray", children: " \u00B7 " }), _jsx(Text, { color: "green", children: "Enter" }), _jsx(Text, { color: "gray", children: " to select \u00B7 " }), _jsx(Text, { color: "red", children: "Esc" }), _jsx(Text, { color: "gray", children: " to cancel" })] })] }));
 }

package/dist/ui/select.js

@@ -1,6 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useMemo, useState } from 'react';
-import chalk from 'chalk';
 import { Box, Text, useInput } from 'ink';
 const DEFAULT_MAX_ROWS = 18;
 export function SelectList({ title, items, onSelect, onCancel, maxRows = DEFAULT_MAX_ROWS, }) {
@@ -31,7 +30,7 @@ export function SelectList({ title, items, onSelect, onCancel, maxRows = DEFAULT
         }
     });
     if (items.length === 0) {
-        return (_jsxs(Box, { flexDirection: "column", children: [title && _jsx(Text, { children: chalk.bold(title) }), _jsx(Text, { children: "No results." }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: chalk.dim('Press Esc to exit.') }) })] }));
+        return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", padding: 1, children: [title ? (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: title }) })) : null, _jsx(Text, { color: "yellow", children: "No results." }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "Press Esc to exit." }) })] }));
     }
     const selectedRowIndex = selectableIndices[cursor] ?? 0;
     const totalRows = items.length;
@@ -39,13 +38,12 @@ export function SelectList({ title, items, onSelect, onCancel, maxRows = DEFAULT
     const windowStart = Math.min(Math.max(0, selectedRowIndex - Math.floor(effectiveMaxRows / 2)), Math.max(0, totalRows - effectiveMaxRows));
     const windowEnd = Math.min(totalRows, windowStart + effectiveMaxRows);
     const windowed = items.slice(windowStart, windowEnd);
-    return (_jsxs(Box, { flexDirection: "column", children: [title && _jsx(Text, { children: chalk.bold(title) }), windowed.map((row, idx) => {
-                const absoluteIndex = windowStart + idx;
-                const selected = row.type === 'item' && absoluteIndex === selectedRowIndex;
-                if (row.type === 'group') {
-                    const colored = row.color ? chalk.hex(row.color)(`[${row.label}]`) : `[${row.label}]`;
-                    return (_jsx(Box, { marginTop: idx === 0 ? 0 : 1, children: _jsx(Text, { children: chalk.bold(colored) }) }, `group-${absoluteIndex}`));
-                }
-                return (_jsxs(Box, { children: [_jsxs(Text, { children: [selected ? chalk.cyan.bold('› ') : '  ', selected ? chalk.cyan.bold(row.label) : row.label] }), row.hint ? _jsx(Text, { children: chalk.dim(` ${row.hint}`) }) : null] }, `item-${absoluteIndex}`));
-            }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: chalk.dim('Use ↑/↓ or j/k. Enter to select. Esc to cancel.') }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", padding: 1, children: [title ? (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: title }) })) : null, _jsx(Box, { flexDirection: "column", children: windowed.map((row, idx) => {
+                    const absoluteIndex = windowStart + idx;
+                    const selected = row.type === 'item' && absoluteIndex === selectedRowIndex;
+                    if (row.type === 'group') {
+                        return (_jsx(Box, { marginTop: idx === 0 ? 0 : 1, children: _jsxs(Text, { bold: true, color: row.color ?? 'cyan', children: ["[", row.label, "]"] }) }, `group-${absoluteIndex}`));
+                    }
+                    return (_jsxs(Box, { flexDirection: "row", children: [_jsxs(Text, { color: selected ? 'green' : undefined, bold: selected, children: [selected ? '› ' : '  ', row.label] }), row.hint ? (_jsxs(Text, { color: "gray", children: [" ", row.hint] })) : null] }, `item-${absoluteIndex}`));
+                }) }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "yellow", children: "\u2191/\u2193 or j/k" }), _jsx(Text, { color: "gray", children: " \u00B7 " }), _jsx(Text, { color: "green", children: "Enter" }), _jsx(Text, { color: "gray", children: " to select \u00B7 " }), _jsx(Text, { color: "red", children: "Esc" }), _jsx(Text, { color: "gray", children: " to cancel" })] })] }));
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bet-cli",
   "description": "Explore and jump between local projects.",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "author": "Chris Mckenzie",
   "license": "Apache-2.0",
   "repository": {
@@ -23,6 +23,7 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@types/marked-terminal": "^6.1.1",
     "@types/object-hash": "^3.0.6",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
@@ -31,6 +32,8 @@
     "ink": "^6.6.0",
     "ink-markdown": "^1.0.4",
     "ink-table": "^3.1.0",
+    "marked": "^17.0.3",
+    "marked-terminal": "^7.3.0",
     "object-hash": "^3.0.0",
     "react": "^19.2.4"
   },

package/src/commands/ignore.ts

@@ -38,7 +38,7 @@ export function registerIgnore(program: Command): void {
       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`,
+          `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/src/commands/info.tsx

@@ -1,23 +1,45 @@
 import chalk from "chalk";
 import { Command } from "commander";
-import { readConfig } from "../lib/config.js";
+import React from "react";
 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 { SelectEntry } from "../ui/select.js";
 import { readReadmeContent } from "../lib/readme.js";
-import Table from "../ui/table.js";
-
-const data: { [key: string]: string }[] = [];
+import Markdown from "../ui/markdown.js";
+
+type MetaRowProps = {
+  label: string;
+  value: string;
+  valueColor?:
+    | "green"
+    | "red"
+    | "yellow"
+    | "blue"
+    | "cyan"
+    | "magenta"
+    | "gray";
+};
+
+const MetaRow: React.FC<MetaRowProps> = ({ label, value, valueColor }) => (
+  <Box>
+    <Text bold color="gray">{`${label}: `}</Text>
+    <Text color={valueColor} bold={!!valueColor}>
+      {value}
+    </Text>
+  </Box>
+);
 
 export function registerInfo(program: Command): void {
   program
     .command("info <slug>")
     .description("Show project details")
     .option("--json", "Print JSON output")
-    .action(async (slug: string, options: { json?: boolean }) => {
+    .option("--full", "Show full README content")
+    .action(async (slug: string, options: { json?: boolean; full?: boolean }) => {
       const config = await readConfig();
       const projects = listProjects(config);
       const matches = findBySlug(projects, slug);
@@ -67,58 +89,96 @@ export function registerInfo(program: Command): void {
       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: React.FC<{ children: string }> | null = null;
-        try {
-          const markdownModule = await import("ink-markdown");
-          Markdown = (markdownModule.default ??
-            markdownModule) as unknown as React.FC<{
-            children: string;
-          }>;
-        } catch {
-          Markdown = null;
-        }
-
         const view = (
-          <Box flexDirection="column">
-            <Table data={data} />
-            <Text color="green" bold>
-              {project.slug}
-            </Text>
-            <Text dimColor>{project.path}</Text>
-            <Box marginTop={1} flexDirection="column">
-              <Text bold>{`Root: ${project.rootName}`}</Text>
-              <Text bold>{`Root path: ${project.root}`}</Text>
-              <Text bold>{`Git: ${hasGit ? "yes" : "no"}`}</Text>
-              <Text bold>{`README: ${project.hasReadme ? "yes" : "no"}`}</Text>
-              <Text
-                bold
-              >{`Started: ${formatDate(project.auto.startedAt)}`}</Text>
-              <Text
-                bold
-              >{`Last modified: ${formatDate(project.auto.lastModifiedAt)}`}</Text>
-              <Text
-                bold
-              >{`Last indexed: ${formatDate(project.auto.lastIndexedAt)}`}</Text>
-              <Text
-                bold
-              >{`Dirty: ${dirty === undefined ? "unknown" : dirty ? "yes" : "no"}`}</Text>
-              {project.user?.tags?.length ? (
-                <Text>{`Tags: ${project.user.tags.join(", ")}`}</Text>
-              ) : null}
-              {project.user?.onEnter ? (
-                <Text>{`On enter: ${project.user.onEnter}`}</Text>
-              ) : null}
+          <Box flexDirection="column" width="100%">
+            <Box
+              width="100%"
+              borderStyle="single"
+              borderColor="green"
+              paddingX={1}
+              paddingY={1}
+              marginBottom={1}
+            >
+              <Text color="green" bold>
+                {project.slug}
+              </Text>
+              <Text color="cyan">{project.path}</Text>
+            </Box>
+            <Box
+              borderStyle="round"
+              borderColor="cyan"
+              padding={1}
+              flexDirection="column"
+              marginBottom={1}
+            >
+              <Box marginBottom={1}>
+                <Text bold color="magenta">
+                  Details
+                </Text>
+              </Box>
+              <Box flexDirection="column">
+                <MetaRow label="Root" value={project.rootName} />
+                <MetaRow label="Root path" value={project.root} />
+                <MetaRow
+                  label="Git"
+                  value={hasGit ? "yes" : "no"}
+                  valueColor={hasGit ? "green" : "yellow"}
+                />
+                <MetaRow
+                  label="README"
+                  value={project.hasReadme ? "yes" : "no"}
+                  valueColor={project.hasReadme ? "green" : "yellow"}
+                />
+                <MetaRow
+                  label="Started"
+                  value={formatDate(project.auto.startedAt)}
+                />
+                <MetaRow
+                  label="Last modified"
+                  value={formatDate(project.auto.lastModifiedAt)}
+                />
+                <MetaRow
+                  label="Last indexed"
+                  value={formatDate(project.auto.lastIndexedAt)}
+                />
+                <MetaRow
+                  label="Dirty"
+                  value={dirty === undefined ? "unknown" : dirty ? "yes" : "no"}
+                  valueColor={
+                    dirty === undefined ? "yellow" : dirty ? "red" : "green"
+                  }
+                />
+                {project.user?.tags?.length ? (
+                  <Box>
+                    <Text bold color="gray">{`Tags: `}</Text>
+                    <Text color="magenta">{project.user.tags.join(", ")}</Text>
+                  </Box>
+                ) : null}
+                {project.user?.onEnter ? (
+                  <Box>
+                    <Text bold color="gray">{`On enter: `}</Text>
+                    <Text color="blue">{project.user.onEnter}</Text>
+                  </Box>
+                ) : null}
+              </Box>
             </Box>
-            <Box marginTop={1} flexDirection="column">
-              <Text>{chalk.bold("Description")}</Text>
-              {Markdown ? (
-                <Markdown>{markdown}</Markdown>
-              ) : (
-                <Text>{markdown}</Text>
-              )}
+            <Box
+              borderStyle="round"
+              borderColor="magenta"
+              padding={1}
+              flexDirection="column"
+            >
+              <Box marginBottom={1}>
+                <Text bold color="magenta">
+                  Description
+                </Text>
+              </Box>
+              <Markdown>{markdown}</Markdown>
             </Box>
           </Box>
         );
@@ -139,7 +199,11 @@ export function registerInfo(program: Command): void {
         `${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`,
       );

package/src/commands/list.ts

@@ -1,15 +1,22 @@
-import chalk from 'chalk';
-import { Command } from 'commander';
-import { readConfig } from '../lib/config.js';
-import path from 'node:path';
-import { listProjects } from '../lib/projects.js';
-import type { Project, RootConfig } from '../lib/types.js';
-import { emitSelection } from '../utils/output.js';
-import { promptSelect } from '../ui/prompt.js';
-import { SelectRow } from '../ui/select.js';
+import chalk from "chalk";
+import { Command } from "commander";
+import { readConfig } from "../lib/config.js";
+import path from "node:path";
+import { listProjects } from "../lib/projects.js";
+import type { Project, RootConfig } from "../lib/types.js";
+import { emitSelection } from "../utils/output.js";
+import { promptSelect } from "../ui/prompt.js";
+import { SelectRow } from "../ui/select.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: number): string {
   return GROUP_COLORS[index % GROUP_COLORS.length];
@@ -28,7 +35,10 @@ function orderedGroupsByConfigRoots(
   projects: Project[],
   roots: RootConfig[],
 ): { rootName: string; items: Project[] }[] {
-  const groupsByRoot = new Map<string, { rootName: string; items: Project[] }>();
+  const groupsByRoot = new Map<
+    string,
+    { rootName: string; items: Project[] }
+  >();
   for (const project of projects) {
     const key = project.root;
     if (!groupsByRoot.has(key)) {
@@ -60,58 +70,76 @@ function orderedGroupsByConfigRoots(
 
 export function registerList(program: Command): void {
   program
-    .command('list')
-    .description('List projects')
-    .option('--plain', 'Print a non-interactive list')
-    .option('--json', 'Print JSON output')
-    .option('--print', 'Print selected path only')
-    .action(async (options: { plain?: boolean; json?: boolean; print?: boolean }) => {
-      const config = await readConfig();
-      const projects = listProjects(config);
+    .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: { plain?: boolean; json?: boolean; print?: boolean }) => {
+        const config = await readConfig();
+        const projects = listProjects(config);
 
-      if (options.json) {
-        process.stdout.write(JSON.stringify(projects, null, 2));
-        process.stdout.write('\n');
-        return;
-      }
+        if (options.json) {
+          process.stdout.write(JSON.stringify(projects, null, 2));
+          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');
+        if (!process.stdin.isTTY || options.plain) {
+          if (projects.length === 0) {
+            process.stdout.write("No projects indexed. Run bet update.\n");
+            return;
+          }
+          const orderedGroups = orderedGroupsByConfigRoots(
+            projects,
+            config.roots,
+          );
+          let groupIndex = 0;
+          for (const { rootName, items } of orderedGroups) {
+            const color = groupColor(groupIndex++);
+            const label = chalk.hex(color).bold(`[${rootName}]`);
+            process.stdout.write(`${label}\n`);
+            for (const project of items) {
+              const rel = relativePath(project.path, project.root);
+              process.stdout.write(
+                `  ${chalk.reset(formatLabel(project.slug, project.rootName, rel))}\n`,
+              );
+            }
+          }
           return;
         }
-        const orderedGroups = orderedGroupsByConfigRoots(projects, config.roots);
+
+        const orderedGroups = orderedGroupsByConfigRoots(
+          projects,
+          config.roots,
+        );
+        const rows: SelectRow<Project>[] = [];
         let groupIndex = 0;
         for (const { rootName, items } of orderedGroups) {
-          const color = groupColor(groupIndex++);
-          const label = chalk.hex(color).bold(`[${rootName}]`);
-          process.stdout.write(`${label}\n`);
+          rows.push({
+            type: "group",
+            label: rootName,
+            color: groupColor(groupIndex++),
+          });
           for (const project of items) {
             const rel = relativePath(project.path, project.root);
-            process.stdout.write(`  ${chalk.reset(formatLabel(project.slug, project.rootName, rel))}\n`);
+            rows.push({
+              type: "item",
+              label: formatLabel(project.slug, project.rootName, rel),
+              value: project,
+            });
           }
         }
-        return;
-      }
-
-      const orderedGroups = orderedGroupsByConfigRoots(projects, config.roots);
-      const rows: SelectRow<Project>[] = [];
-      let groupIndex = 0;
-      for (const { rootName, items } of orderedGroups) {
-        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',
-            label: formatLabel(project.slug, project.rootName, rel),
-            value: project,
-          });
-        }
-      }
 
-      const selected = await promptSelect(rows, { title: 'Projects', maxRows: MAX_ROWS });
-      if (!selected) return;
+        const selected = await promptSelect(rows, {
+          title: "Projects",
+          maxRows: MAX_ROWS,
+        });
+        if (!selected) return;
 
-      emitSelection(selected.value, { printOnly: options.print });
-    });
+        emitSelection(selected.value, { printOnly: options.print });
+      },
+    );
 }

package/src/commands/update.ts

@@ -162,6 +162,7 @@ export function registerUpdate(program: Command): void {
         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 }),

package/src/index.ts

@@ -1,35 +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(this: Command) {
-  return Object.assign(new GroupedHelp(), this.configureHelp());
-};
-
-program
-  .name("bet")
-  .description("Explore and jump between local projects.")
-  .version("0.1.4");
-
-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");

package/src/lib/config.ts

@@ -95,6 +95,7 @@ async function readProjectsConfig(): Promise<ProjectsConfig> {
     const parsed = JSON.parse(raw) as ProjectsConfig;
     return {
       projects: parsed.projects ?? {},
+      ...(parsed.updatedAt != null && typeof parsed.updatedAt === "string" && { updatedAt: parsed.updatedAt }),
     };
   } catch (error) {
     return { ...DEFAULT_PROJECTS_CONFIG };
@@ -123,6 +124,7 @@ export async function readConfig(): Promise<Config> {
   return {
     ...appConfig,
     projects: normalizedProjects,
+    ...(projectsConfig.updatedAt != null && { updatedAt: projectsConfig.updatedAt }),
   };
 }
 
@@ -150,6 +152,7 @@ export async function writeConfig(config: Config): Promise<void> {
   };
   const projectsConfig: ProjectsConfig = {
     projects: config.projects,
+    ...(config.updatedAt !== undefined && { updatedAt: config.updatedAt }),
   };
   await Promise.all([
     writeAppConfig(appConfig),

package/src/lib/readme.ts

@@ -20,6 +20,7 @@ export async function readReadmePath(
 
 export async function readReadmeContent(
   projectPath: string,
+  options?: { full?: boolean },
 ): Promise<string | undefined> {
   const readmePath = await readReadmePath(projectPath);
   if (!readmePath) return undefined;
@@ -28,7 +29,11 @@ export async function readReadmeContent(
   // 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}...`;

package/src/lib/types.ts

@@ -40,6 +40,7 @@ export type AppConfig = {
 
 export type ProjectsConfig = {
   projects: Record<string, Project>;
+  updatedAt?: string;
 };
 
 export type Config = {
@@ -49,6 +50,7 @@ export type Config = {
   ignoredPaths?: string[];
   slugParentFolders?: string[];
   projects: Record<string, Project>;
+  updatedAt?: string;
 };
 
 export type ProjectCandidate = {

package/src/main.ts

@@ -0,0 +1,55 @@
+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 ASCII_HEADER = `
+                            ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░
+                        ░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░
+                    ░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░
+                ░░░░░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░
+            ░░░░░░░░░░░░░   ░░░░░   ░░░░░░                                 ░░░░░░
+        ░░░░░░░░░░░░░       ░░░░░   ░░░░░░                                 ░░░░░░
+      ░░░░░░░░░░░░          ░░░░░   ░░░░░░                                 ░░░░░░
+         ░░░░░░░░░░░░░░░░   ░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+              ░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+                   ░░░░░░░░░░░░░░   ░░░░░░                                 ░░░░░░
+                        ░░░░░░░░░   ░░░░░░                                 ░░░░░░
+                            ░░░░░   ░░░░░░                                 ░░░░░░
+                            ░░░░░   ░░░░░░                                 ░░░░░░
+                            ░░░░░   ░░░░░░                                 ░░░░░░
+       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+       ░░░░░░░░░░░░░░░░░░░░░░░░░░   ░░░░░░░░░░░░░░░░░░░░░░░░░░             ░░░░░░
+`;
+
+const program = new Command();
+
+program.createHelp = function createHelp(this: Command) {
+  return Object.assign(new GroupedHelp(), this.configureHelp());
+};
+
+program
+  .name("bet")
+  .description("Explore and jump between local projects.")
+  .version("0.2.0");
+
+registerUpdate(program);
+registerList(program);
+registerSearch(program);
+registerInfo(program);
+registerGo(program);
+registerPath(program);
+registerShell(program);
+registerCompletion(program);
+registerIgnore(program);
+
+program.addHelpText("before", ASCII_HEADER);
+
+program.parseAsync(process.argv);

package/src/ui/markdown.tsx

@@ -0,0 +1,14 @@
+import { Text } from "ink";
+import { marked, type MarkedExtension } from "marked";
+import { markedTerminal, type TerminalRendererOptions } from "marked-terminal";
+import React from "react";
+
+export type Props = TerminalRendererOptions & {
+  children: string;
+};
+
+export default function Markdown({ children, ...options }: Props) {
+  marked.use(markedTerminal(options) as MarkedExtension);
+  const parsedMarkdown = marked.parse(children, { async: false }) as string;
+  return React.createElement(Text, null, parsedMarkdown.trim());
+}

package/src/ui/search.tsx

@@ -1,5 +1,4 @@
 import React, { useMemo, useState } from 'react';
-import chalk from 'chalk';
 import { Box, Text, useInput } from 'ink';
 import { SelectEntry } from './select.js';
 
@@ -67,10 +66,22 @@ export function SearchSelect<T>({
 
   if (items.length === 0) {
     return (
-      <Box flexDirection="column">
-        {title && <Text>{chalk.bold(title)}</Text>}
-        <Text>{`Search: ${query}`}</Text>
-        <Text>No results.</Text>
+      <Box flexDirection="column" borderStyle="round" borderColor="magenta" padding={1}>
+        {title ? (
+          <Box marginBottom={1}>
+            <Text bold color="cyan">
+              {title}
+            </Text>
+          </Box>
+        ) : null}
+        <Box marginBottom={1} flexDirection="row">
+          <Text bold color="yellow">Search: </Text>
+          <Text color="cyan">{query || '…'}</Text>
+        </Box>
+        <Text color="yellow">No results.</Text>
+        <Box marginTop={1}>
+          <Text color="gray">Press Esc to exit.</Text>
+        </Box>
       </Box>
     );
   }
@@ -86,25 +97,45 @@ export function SearchSelect<T>({
   const windowed = items.slice(windowStart, windowEnd);
 
   return (
-    <Box flexDirection="column">
-      {title && <Text>{chalk.bold(title)}</Text>}
-      <Text>{`Search: ${query}`}</Text>
-      {showCount && <Text>{chalk.dim(`${items.length} result(s)`)}</Text>}
-      {windowed.map((row, idx) => {
-        const absoluteIndex = windowStart + idx;
-        const selected = absoluteIndex === selectedRowIndex;
-        return (
-          <Box key={`item-${absoluteIndex}`}>
-            <Text>
-              {selected ? chalk.cyan.bold('› ') : '  '}
-              {selected ? chalk.cyan.bold(row.label) : row.label}
-            </Text>
-            {row.hint ? <Text>{chalk.dim(` ${row.hint}`)}</Text> : null}
-          </Box>
-        );
-      })}
-      <Box marginTop={1}>
-        <Text>{chalk.dim('Type to filter. Use ↑/↓ or j/k. Enter to select. Esc to cancel.')}</Text>
+    <Box flexDirection="column" borderStyle="round" borderColor="magenta" padding={1}>
+      {title ? (
+        <Box marginBottom={1}>
+          <Text bold color="cyan">
+            {title}
+          </Text>
+        </Box>
+      ) : null}
+      <Box marginBottom={1} flexDirection="row">
+        <Text bold color="yellow">Search: </Text>
+        <Text color="green">{query || '…'}</Text>
+        {showCount ? (
+          <Text color="cyan"> · {items.length} result{items.length !== 1 ? 's' : ''}</Text>
+        ) : null}
+      </Box>
+      <Box flexDirection="column">
+        {windowed.map((row, idx) => {
+          const absoluteIndex = windowStart + idx;
+          const selected = absoluteIndex === selectedRowIndex;
+          return (
+            <Box key={`item-${absoluteIndex}`} flexDirection="row">
+              <Text color={selected ? 'green' : undefined} bold={selected}>
+                {selected ? '› ' : '  '}
+                {row.label}
+              </Text>
+              {row.hint ? <Text color="gray"> {row.hint}</Text> : null}
+            </Box>
+          );
+        })}
+      </Box>
+      <Box marginTop={1} flexDirection="row">
+        <Text color="yellow">Type to filter</Text>
+        <Text color="gray"> · </Text>
+        <Text color="yellow">↑/↓ or j/k</Text>
+        <Text color="gray"> · </Text>
+        <Text color="green">Enter</Text>
+        <Text color="gray"> to select · </Text>
+        <Text color="red">Esc</Text>
+        <Text color="gray"> to cancel</Text>
       </Box>
     </Box>
   );

package/src/ui/select.tsx

@@ -1,5 +1,4 @@
 import React, { useMemo, useState } from 'react';
-import chalk from 'chalk';
 import { Box, Text, useInput } from 'ink';
 
 export type SelectGroup = {
@@ -65,11 +64,17 @@ export function SelectList<T>({
 
   if (items.length === 0) {
     return (
-      <Box flexDirection="column">
-        {title && <Text>{chalk.bold(title)}</Text>}
-        <Text>No results.</Text>
+      <Box flexDirection="column" borderStyle="round" borderColor="magenta" padding={1}>
+        {title ? (
+          <Box marginBottom={1}>
+            <Text bold color="cyan">
+              {title}
+            </Text>
+          </Box>
+        ) : null}
+        <Text color="yellow">No results.</Text>
         <Box marginTop={1}>
-        <Text>{chalk.dim('Press Esc to exit.')}</Text>
+          <Text color="gray">Press Esc to exit.</Text>
         </Box>
       </Box>
     );
@@ -86,33 +91,49 @@ export function SelectList<T>({
   const windowed = items.slice(windowStart, windowEnd);
 
   return (
-    <Box flexDirection="column">
-      {title && <Text>{chalk.bold(title)}</Text>}
-      {windowed.map((row, idx) => {
-        const absoluteIndex = windowStart + idx;
-        const selected = row.type === 'item' && absoluteIndex === selectedRowIndex;
+    <Box flexDirection="column" borderStyle="round" borderColor="magenta" padding={1}>
+      {title ? (
+        <Box marginBottom={1}>
+          <Text bold color="cyan">
+            {title}
+          </Text>
+        </Box>
+      ) : null}
+      <Box flexDirection="column">
+        {windowed.map((row, idx) => {
+          const absoluteIndex = windowStart + idx;
+          const selected = row.type === 'item' && absoluteIndex === selectedRowIndex;
+
+          if (row.type === 'group') {
+            return (
+              <Box key={`group-${absoluteIndex}`} marginTop={idx === 0 ? 0 : 1}>
+                <Text bold color={row.color ?? 'cyan'}>
+                  [{row.label}]
+                </Text>
+              </Box>
+            );
+          }
 
-        if (row.type === 'group') {
-          const colored = row.color ? chalk.hex(row.color)(`[${row.label}]`) : `[${row.label}]`;
           return (
-            <Box key={`group-${absoluteIndex}`} marginTop={idx === 0 ? 0 : 1}>
-              <Text>{chalk.bold(colored)}</Text>
+            <Box key={`item-${absoluteIndex}`} flexDirection="row">
+              <Text color={selected ? 'green' : undefined} bold={selected}>
+                {selected ? '› ' : '  '}
+                {row.label}
+              </Text>
+              {row.hint ? (
+                <Text color="gray"> {row.hint}</Text>
+              ) : null}
             </Box>
           );
-        }
-
-        return (
-          <Box key={`item-${absoluteIndex}`}>
-            <Text>
-              {selected ? chalk.cyan.bold('› ') : '  '}
-              {selected ? chalk.cyan.bold(row.label) : row.label}
-            </Text>
-            {row.hint ? <Text>{chalk.dim(` ${row.hint}`)}</Text> : null}
-          </Box>
-        );
-      })}
+        })}
+      </Box>
       <Box marginTop={1}>
-        <Text>{chalk.dim('Use ↑/↓ or j/k. Enter to select. Esc to cancel.')}</Text>
+        <Text color="yellow">↑/↓ or j/k</Text>
+        <Text color="gray"> · </Text>
+        <Text color="green">Enter</Text>
+        <Text color="gray"> to select · </Text>
+        <Text color="red">Esc</Text>
+        <Text color="gray"> to cancel</Text>
       </Box>
     </Box>
   );