@tanagram/lore 0.1.76 → 0.1.78

package/README.md

@@ -19,10 +19,13 @@ contract:
 
 Adding directories takes a single keystroke on first login — the TUI
 shows your most-recent Claude Code project cwds with the top three
-pre-checked, and pressing Enter accepts them. After that, manage the
-list with `lore listen`:
+pre-checked, and pressing Enter accepts them. `lore listen configure`
+re-enters that same interactive flow any time (it's also one of the
+quick actions on the `lore` dashboard). For scripted/non-interactive
+edits, manage the list directly:
 
 ```sh
+lore listen configure                         # re-run the interactive wizard
 lore listen create ~/code/projectA            # watch ~/code/projectA
 lore listen create ~/work --workspace acme          # route work to a non-default workspace
 lore listen list                              # tabular output
@@ -109,6 +112,24 @@ The plain path is also taken automatically whenever:
 See [AGENTS.md](./AGENTS.md) for the contributor guide on adding new
 screens, the presentation/handler split, and the TTY-detection contract.
 
+### TUI story runner
+
+Use the terminal story runner to review seeded Ink states without touching
+WorkOS, the Lore API, launchd, or local Lore config:
+
+```sh
+pnpm tui:stories                         # interactive browser
+pnpm tui:stories --story dashboard/healthy
+pnpm tui:stories --list                  # print available story ids
+```
+
+Stories live under `src/tui/stories/` and import screen components rather
+than `*Entrypoint.tsx` files. Keep new stories fixture-driven: pass explicit
+state, timestamps, and no-op callbacks so story review never performs command
+side effects. In the interactive runner, use ↑/↓ or j/k to choose a story,
+Tab to focus the preview so nested controls own the keyboard, Shift+Tab or
+Esc to return to the sidebar, and q to exit.
+
 ## Subcommands
 
 - `lore` — opens the interactive dashboard in a TTY; prints help text
@@ -125,6 +146,9 @@ screens, the presentation/handler split, and the TTY-detection contract.
 - `lore disable` — stops and removes the macOS background uploader.
 - `lore restart` — restarts the macOS background uploader.
 - `lore status` / `lore status --json` — shows background uploader health.
+- `lore listen configure` — re-enter the interactive wizard for picking
+  the directories Lore auto-uploads from (the same flow shown on first
+  login). Requires an interactive terminal.
 - `lore listen create <path> [--workspace <name>]` — allowlist a directory for
   daemon auto-uploads. Defaults to your active workspace; pass workspace
   `--workspace` to route a directory at a non-default workspace.