bet-cli 0.2.0 → 0.3.1

package/landing-page/vercel.json

@@ -0,0 +1,25 @@
+{
+  "headers": [
+    {
+      "source": "/(.*)",
+      "headers": [
+        {
+          "key": "Referrer-Policy",
+          "value": "strict-origin-when-cross-origin"
+        },
+        {
+          "key": "X-Content-Type-Options",
+          "value": "nosniff"
+        },
+        {
+          "key": "X-Frame-Options",
+          "value": "DENY"
+        },
+        {
+          "key": "Permissions-Policy",
+          "value": "camera=(), microphone=(), geolocation=()"
+        }
+      ]
+    }
+  ]
+}

package/package.json

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

package/skills/bet/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: bet
+description: Use the bet CLI to find, inspect, and jump between local projects from natural-language requests. Triggers on requests like "jump to my X project", "open the api repo in my editor", "what's the path to X", "find projects matching Y", "which of my projects have uncommitted changes", "list projects I haven't touched in N months", or any task where the user refers to a local project by name/topic instead of by path. Also use when the user types /bet.
+---
+
+# bet
+
+`bet` is a local project index. It scans configured root folders, detects projects by `.git`/`README.md`, and exposes them through fast lookup commands. Treat it as the canonical way to resolve a project name → an absolute path on this machine.
+
+## Quick command map
+
+Map the user's intent to a command. Always use the slug (kebab-case folder name), not a fuzzy display name.
+
+| User asks for… | Run |
+|---|---|
+| The path to project `X` | `bet path X` |
+| Details / metadata about `X` (description, root, git state) | `bet info X --json` |
+| The full README of `X` | `bet info X --full` |
+| A list of all projects | `bet list --json` |
+| Search by keyword `Y` | `bet search Y --json` |
+| Open `X` in the user's editor | `bet edit X` |
+| Re-scan disk for new projects | `bet update` |
+| Add/remove/list ignored paths | `bet ignore add <path>` / `bet ignore rm <path>` / `bet ignore list` |
+
+## Non-interactive flags are mandatory
+
+`bet list` and `bet search` launch an interactive TUI by default. **Never** run them without `--plain` or `--json` from an agent context — they will hang waiting for keystrokes.
+
+- `--json` — machine-readable, the right default for filtering/parsing
+- `--plain` — line-per-project text, fine when only a name is needed
+- `--print` — emit the selected absolute path only
+
+## Resolving a path before `cd`
+
+`bet go <slug>` only changes the shell's directory when the user has the shell integration (`eval "$(bet shell)"`) active. From a Bash tool call, that integration is **not** loaded, so `bet go` will not actually `cd`.
+
+When you need to enter a project directory inside a Bash tool call, resolve the path first:
+
+```sh
+cd "$(bet path X)" && <command>
+```
+
+This works without any shell integration and is the correct pattern for agent-driven workflows.
+
+## The `--json` schema
+
+`bet list --json` and `bet info <slug> --json` return objects with these fields:
+
+```jsonc
+{
+  "id": "/abs/path",            // unique id (= path)
+  "slug": "my-project",         // use this with all commands
+  "name": "my-project",
+  "path": "/abs/path",
+  "root": "/abs/root",          // which configured root it lives under
+  "rootName": "code",           // friendly root label
+  "hasGit": true,
+  "hasReadme": true,
+  "auto": {
+    "description": "...",        // first paragraph of README
+    "startedAt": "ISO-8601",     // first git commit date
+    "lastModifiedAt": "ISO-8601",// most recent file mtime
+    "lastIndexedAt": "ISO-8601",
+    "dirty": true                // uncommitted changes
+  }
+}
+```
+
+`bet list --json` returns an array of these.
+
+## `--json | jq` recipes
+
+The single highest-leverage feature for an agent. Reach for these when the user asks anything analytical about their projects:
+
+```sh
+# Projects with uncommitted work
+bet list --json | jq 'map(select(.auto.dirty)) | .[].slug'
+
+# Projects modified in the last 30 days, newest first
+bet list --json | jq 'sort_by(.auto.lastModifiedAt) | reverse | map(select(.auto.lastModifiedAt > (now - 86400*30 | todateiso8601)))'
+
+# Stale projects (untouched > 6 months)
+bet list --json | jq --arg cutoff "$(date -u -v-6m +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -d '6 months ago' +%Y-%m-%dT%H:%M:%SZ)" \
+  'map(select(.auto.lastModifiedAt < $cutoff)) | .[].slug'
+
+# Group projects by root
+bet list --json | jq 'group_by(.rootName) | map({root: .[0].rootName, count: length, slugs: map(.slug)})'
+
+# Projects whose description mentions a keyword
+bet list --json | jq --arg q "rust" 'map(select(.auto.description | test($q; "i"))) | .[].slug'
+```
+
+Compose `jq` filters from `auto.*` fields rather than re-implementing logic in shell. The user's README at `bet --help` calls out this pattern explicitly.
+
+## When `bet` returns nothing
+
+If `bet list --json` is empty or `bet path X` errors with an unknown slug, the user has not indexed yet (or the index is stale). Run:
+
+```sh
+bet update
+```
+
+If this is their first run, `bet update` will fail without roots. Tell the user to run:
+
+```sh
+bet update --roots "$HOME/code,$HOME/work"
+```
+
+…with whatever roots make sense for their machine. Do not pick roots for them.
+
+## Slug rules — what to actually pass
+
+- The slug is the project folder's basename, kebab-cased.
+- If the project sits inside a wrapper folder named in `slugParentFolders` (defaults: `src`, `app`), the slug is the **parent's** name. Example: `~/code/foo/src` → slug `foo`, not `src`.
+- When unsure, run `bet search <fuzzy>` first and read back the slug from JSON.
+
+## Common pitfalls
+
+- **TUI hang** — `bet list` / `bet search` without `--plain`/`--json` will block waiting for keystrokes. Always pass one.
+- **`bet go` in Bash** — won't actually change directory; use `cd "$(bet path X)"` instead.
+- **Treating the name as the slug** — `bet info "My Project"` will fail; use the slug from `bet list --json`.
+- **Stale index after creating a new project** — run `bet update` before assuming the new project is searchable. Suggest `bet update --cron 1h` if the user creates projects often.
+- **Editing config by hand** — config lives at `~/.config/bet/config.json` (or `$XDG_CONFIG_HOME/bet/config.json`). Prefer commands (`bet update --roots`, `bet ignore add`) over hand-editing.
+
+## File locations (for debugging only)
+
+- Config + ignore list: `~/.config/bet/config.json`
+- Project index: `~/.config/bet/projects.json`
+- Logs: `~/Library/Logs/bet/bet.log` (macOS) or `~/.local/state/bet/bet.log` (Linux). Set `BET_LOG_LEVEL=debug` for verbose output.

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;
+      }
+    });
+}

package/src/commands/info.tsx

@@ -39,194 +39,219 @@ export function registerInfo(program: Command): void {
     .description("Show project details")
     .option("--json", "Print JSON output")
     .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);
-
-      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`);
-          }
+    .action(
+      async (slug: string, options: { json?: boolean; full?: boolean }) => {
+        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;
         }
 
-        const items: SelectEntry<(typeof matches)[number]>[] = matches.map(
-          (item) => ({
-            label: projectLabel(item),
-            hint: item.path,
-            value: item,
-            type: "item",
-          }),
-        );
+        let project = matches[0];
 
-        const selected = await promptSelect(items, { title: `Select ${slug}` });
-        if (!selected) return;
-        project = selected.value;
-      }
-
-      if (options.json) {
-        process.stdout.write(JSON.stringify(project, null, 2));
-        process.stdout.write("\n");
-        return;
-      }
-
-      const description =
-        project.user?.description ?? project.auto.description ?? "—";
-      // Compute git status live
-      const hasGit = await isInsideGitRepo(project.path);
-      const dirty = hasGit ? await getDirtyStatus(project.path) : undefined;
-
-      if (process.stdin.isTTY) {
-        const readme = options.full
-          ? await readReadmeContent(project.path, { full: true })
-          : null;
-        const markdown = readme ?? description;
-
-        const view = (
-          <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>
+        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;
+        }
+
+        if (options.json) {
+          process.stdout.write(JSON.stringify(project, null, 2));
+          process.stdout.write("\n");
+          return;
+        }
+
+        const description =
+          project.user?.description ?? project.auto.description ?? "—";
+        // Compute git status live
+        const hasGit = await isInsideGitRepo(project.path);
+        const dirty = hasGit ? await getDirtyStatus(project.path) : undefined;
+
+        if (process.stdin.isTTY) {
+          const readme = options.full
+            ? await readReadmeContent(project.path, { full: true })
+            : null;
+          const markdown = readme ?? description;
+
+          const view = (
+            <Box flexDirection="column" width="100%">
+              <Box
+                width="100%"
+                borderStyle="single"
+                borderColor="green"
+                paddingX={1}
+                paddingY={1}
+                marginBottom={1}
+                flexDirection="column"
+              >
+                <Box width="100%" paddingBottom={1}>
+                  <Text color="green" bold>
+                    {project.slug}
+                  </Text>
+                </Box>
+                <Box width="100%">
+                  <Text color="cyan">{project.path}</Text>
+                </Box>
               </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
+                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="Git"
+                    value={hasGit ? "yes" : "no"}
+                    valueColor={hasGit ? "green" : "yellow"}
+                  />
+                  <MetaRow
+                    label="Git dirty"
+                    value={
+                      dirty === undefined ? "unknown" : dirty ? "yes" : "no"
+                    }
+                    valueColor={
+                      dirty === undefined ? "yellow" : dirty ? "red" : "green"
+                    }
+                  />
+                  <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="Root" value={project.rootName} />
+                  <MetaRow label="Root path" value={project.root} />
+                  {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>
-            <Box
-              borderStyle="round"
-              borderColor="magenta"
-              padding={1}
-              flexDirection="column"
-            >
-              <Box marginBottom={1}>
-                <Text bold color="magenta">
-                  Description
-                </Text>
+              <Box
+                borderStyle="round"
+                borderColor="magenta"
+                padding={1}
+                flexDirection="column"
+              >
+                <Box marginBottom={1}>
+                  <Text bold color="magenta">
+                    Description
+                  </Text>
+                </Box>
+                <Markdown>{markdown}</Markdown>
               </Box>
-              <Markdown>{markdown}</Markdown>
+              {!options.full && project.hasReadme ? (
+                <Box marginTop={1}>
+                  <Text color="yellow">
+                    Tip: Run <Text bold>bet info {project.slug} --full</Text> to
+                    read the full README.
+                  </Text>
+                </Box>
+              ) : null}
             </Box>
-          </Box>
-        );
+          );
 
-        const { unmount } = render(view, { stdout: process.stdout });
-        await new Promise((resolve) => setTimeout(resolve, 0));
-        unmount();
-        return;
-      }
-
-      process.stdout.write(`${chalk.bold(project.slug)}\n`);
-      process.stdout.write(`${chalk.dim(project.path)}\n\n`);
-
-      process.stdout.write(`${chalk.bold("Root:")} ${project.rootName}\n`);
-      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`,
-      );
-
-      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`,
-      );
-      process.stdout.write(
-        `${chalk.bold("Dirty:")} ${dirty === undefined ? "unknown" : dirty ? "yes" : "no"}\n`,
-      );
-
-      if (project.user?.tags?.length) {
+          const { unmount } = render(view, { stdout: process.stdout });
+          await new Promise((resolve) => setTimeout(resolve, 0));
+          unmount();
+          return;
+        }
+
+        process.stdout.write(`${chalk.bold(project.slug)}\n`);
+        process.stdout.write(`${chalk.dim(project.path)}\n\n`);
+
+        process.stdout.write(`${chalk.bold("Root:")} ${project.rootName}\n`);
+        process.stdout.write(`${chalk.bold("Root path:")} ${project.root}\n`);
         process.stdout.write(
-          `${chalk.bold("Tags:")} ${project.user.tags.join(", ")}\n`,
+          `${chalk.bold("Git:")} ${hasGit ? "yes" : "no"}\n`,
+        );
+        process.stdout.write(
+          `${chalk.bold("README:")} ${project.hasReadme ? "yes" : "no"}\n\n`,
         );
-      }
 
-      if (project.user?.onEnter) {
+        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("On enter:")} ${project.user.onEnter}\n`,
+          `${chalk.bold("Last modified:")} ${formatDate(project.auto.lastModifiedAt)}\n`,
         );
-      }
-    });
+        process.stdout.write(
+          `${chalk.bold("Last indexed:")} ${formatDate(project.auto.lastIndexedAt)}\n`,
+        );
+        process.stdout.write(
+          `${chalk.bold("Dirty:")} ${dirty === undefined ? "unknown" : dirty ? "yes" : "no"}\n`,
+        );
+
+        if (project.user?.tags?.length) {
+          process.stdout.write(
+            `${chalk.bold("Tags:")} ${project.user.tags.join(", ")}\n`,
+          );
+        }
+
+        if (project.user?.onEnter) {
+          process.stdout.write(
+            `${chalk.bold("On enter:")} ${project.user.onEnter}\n`,
+          );
+        }
+      },
+    );
 }