@procrastivity/clast 0.0.3 → 0.0.5

package/README.md

@@ -6,27 +6,30 @@ Capture, curate, and surface Claude Code session history across all your project
 
 ## What it does
 
-- **CLI** (`clast`) — snapshot, browse, and query your Claude Code session JSONL history.
-- **Plugin** — installs skills (`/day-wakeup`, `/wakeup`) that surface recent session context.
+- **CLI** — two binaries, porcelain over plumbing:
+  - `clast` — porcelain (LLM-aware): `clast wake`, `clast brief`. See [run without Claude Code](./docs/guides/run-without-claude-code.md).
+  - `clast-plumbing` — deterministic core: snapshot, browse, and query your Claude Code session JSONL history.
+- **Plugin** — installs skills (`/wake`, `/brief`) that surface recent session context.
 - **SessionStart hook** — quietly snapshots active sessions in the background each time Claude Code starts.
 
 ## Capture your sessions
 
 ```sh
-clast snapshot                       # copy any new sessions into the journal
-clast snapshot --dry-run --json | jq # preview what would be captured
+clast-plumbing snapshot                       # copy any new sessions into the journal
+clast-plumbing snapshot --dry-run --json | jq # preview what would be captured
 ```
 
-`clast snapshot` is idempotent and silent on no-op, safe to run from cron or
-a SessionStart hook. See [`docs/reference/cli.md#clast-snapshot`](./docs/reference/cli.md#clast-snapshot)
+`clast-plumbing snapshot` is idempotent and silent on no-op, safe to run from
+cron or a SessionStart hook. See
+[`docs/reference/cli.md#clast-snapshot`](./docs/reference/cli.md#clast-snapshot)
 for the full flag reference.
 
 ## Read your sessions
 
 ```sh
-clast projects                        # which projects had activity today
-clast sessions --since -7d            # sessions captured in the last week
-clast show <session-uuid> --full      # metadata + first/last turns
+clast-plumbing projects                        # which projects had activity today
+clast-plumbing sessions --since -7d            # sessions captured in the last week
+clast-plumbing show <session-uuid> --full      # metadata + first/last turns
 ```
 
 Window flags (`--day`, `--since`, `--until`) accept ISO dates and
@@ -39,14 +42,14 @@ for the full flag and output schemas.
 ## Curate an entry
 
 ```sh
-clast entries                                            # list curated entries
-clast entries read 2026-05-30-1430-xesapps-foo.md        # cat a single entry
-printf 'Notes...\n' | clast entries write \
-  --session <session-uuid> --slug short-slug --body-stdin # write a new entry
+clast-plumbing entries                                            # list curated entries
+clast-plumbing entries read 2026-05-30-1430-xesapps-foo.md        # cat a single entry
+printf 'Notes...\n' | clast-plumbing entries write \
+  --session <session-uuid> --slug short-slug --body-stdin          # write a new entry
 ```
 
-`clast entries write` looks up the session in the manifest, composes the
-documented frontmatter from the captured snapshot + registry, and writes
+`clast-plumbing entries write` looks up the session in the manifest, composes
+the documented frontmatter from the captured snapshot + registry, and writes
 `entries/YYYY-MM-DD-HHMM-<project-slug>-<session-slug>.md` atomically. See
 [`docs/reference/cli.md#entry-frontmatter`](./docs/reference/cli.md#entry-frontmatter)
 for the full frontmatter schema and
@@ -56,31 +59,31 @@ for the flag reference.
 ## Leave a breadcrumb
 
 ```sh
-clast breadcrumb --project xesapps 'check migration before deploy'
-clast breadcrumb --global 'remember to bump the cache version'
+clast-plumbing breadcrumb --project xesapps 'check migration before deploy'
+clast-plumbing breadcrumb --global 'remember to bump the cache version'
 
-clast breadcrumb --read --project xesapps
-clast breadcrumb --read --global
+clast-plumbing breadcrumb --read --project xesapps
+clast-plumbing breadcrumb --read --global
 ```
 
-Breadcrumbs are append-only one-line notes for `/wakeup` and `/day-wakeup`.
+Breadcrumbs are append-only one-line notes for `/brief` and `/wake`.
 See [`docs/reference/cli.md#clast-breadcrumb`](./docs/reference/cli.md#clast-breadcrumb)
 for the full command contract.
 
 ## Inspect and audit the journal
 
 ```sh
-clast stats                          # one-line activity summary for today
-clast stats --since -7d              # rollup over the last week
+clast-plumbing stats                          # one-line activity summary for today
+clast-plumbing stats --since -7d              # rollup over the last week
 
-clast doctor                         # check manifest, registry, snapshots
-clast doctor --fix                   # rebuild a broken manifest, prune orphans
+clast-plumbing doctor                         # check manifest, registry, snapshots
+clast-plumbing doctor --fix                   # rebuild a broken manifest, prune orphans
 ```
 
 See [`docs/reference/cli.md#clast-stats`](./docs/reference/cli.md#clast-stats)
 and [`docs/reference/cli.md#clast-doctor`](./docs/reference/cli.md#clast-doctor)
-for the contract reference, and `clast stats --help` / `clast doctor --help`
-for the current set of flags.
+for the contract reference, and `clast-plumbing stats --help` /
+`clast-plumbing doctor --help` for the current set of flags.
 
 ## Install to a prefix
 
@@ -102,9 +105,9 @@ for the rationale.
 With Nix flakes enabled, you can use `clast` directly from the public flake:
 
 ```sh
-nix run github:procrastivity/clast -- whereami
 nix profile install github:procrastivity/clast
-nix build .#default && ./result/bin/clast --version
+nix build .#default && ./result/bin/clast --version       # porcelain
+nix build .#default && ./result/bin/clast-plumbing --help # plumbing
 ```
 
 For Home Manager or nix-darwin users, `overlays.default` exposes `pkgs.clast`.
@@ -135,27 +138,27 @@ The plugin can be installed from any local checkout, or via `npm install -g`
 (which puts `.claude-plugin/` under `npm root -g`); a centralized marketplace
 listing is a separate distribution channel deliberately not pursued for v1.
 Today the plugin ships a single `SessionStart` hook: every time a Claude Code
-session starts it backgrounds `clast snapshot`, so your journal stays current
-with zero manual effort. The hook is best-effort and silent: if the `clast` CLI
-isn't on your `PATH` yet, sessions still start cleanly. See
+session starts it backgrounds `clast-plumbing snapshot`, so your journal stays
+current with zero manual effort. The hook is best-effort and silent: if the
+`clast-plumbing` CLI isn't on your `PATH` yet, sessions still start cleanly. See
 [`docs/reference/plugin.md#hook-sessionstart`](./docs/reference/plugin.md#hook-sessionstart)
 for the hook's design rationale.
 
-### `/day-wakeup`
+### `/wake`
 
-At the start of each day, run `/day-wakeup` inside any Claude Code session after
+At the start of each day, run `/wake` inside any Claude Code session after
 the plugin is installed. It performs once-per-day cross-project curation of
 yesterday's sessions into durable journal entries, walking each uncurated session
 through a draft you can accept, edit, skip, or mark for in-entry promotion. See
-[`docs/reference/plugin.md#skill-1-day-wakeup`](./docs/reference/plugin.md#skill-1-day-wakeup).
+[`docs/reference/plugin.md#skill-1-wake`](./docs/reference/plugin.md#skill-1-wake).
 
-### `/wakeup`
+### `/brief`
 
-When starting work on a specific project, run `/wakeup` (or `/wakeup <slug>` from
+When starting work on a specific project, run `/brief` (or `/brief <slug>` from
 anywhere) to get a per-project read-only briefing synthesized from recent curated entries,
-today's breadcrumbs, and any sessions already started today. `/wakeup` never writes — it
+today's breadcrumbs, and any sessions already started today. `/brief` never writes — it
 only reads. See
-[`docs/reference/plugin.md#skill-2-wakeup`](./docs/reference/plugin.md#skill-2-wakeup).
+[`docs/reference/plugin.md#skill-2-brief`](./docs/reference/plugin.md#skill-2-brief).
 
 ## Development
 

package/bin/clast

@@ -1,93 +1,42 @@
 #!/usr/bin/env bash
-# clast — main dispatcher.
+# clast — porcelain over clast-plumbing, with an OpenAI-compatible LLM
+# provider. Owns the `wake` and `brief` subcommands, plus `undismiss` as a
+# convenience passthrough to plumbing (recovers an accidental [d] in wake).
+# Every other verb is a clean error — the porcelain does not broadly proxy.
 #
-# Parses global flags, sources libs, dispatches to a subcommand.
-# Subcommand files live in $CLAST_LIB/clast-subcommands/<name>.bash and
-# each defines a single function `clast_cmd_<name>`.
+# Subcommand files live in $CLAST_LIB/clast-porcelain-subcommands/<name>.bash
+# and each defines a single function `clast_cmd_<name>`.
 set -euo pipefail
 
 CLAST_LIB="${CLAST_LIB:-$(dirname "$(realpath "$0")")/../lib/clast}"
 export CLAST_LIB
 
-# shellcheck source=lib/clast/clast-lib.bash
-source "$CLAST_LIB/clast-lib.bash"
-# shellcheck source=lib/clast/clast-decode-lib.bash
-source "$CLAST_LIB/clast-decode-lib.bash"
-# shellcheck source=lib/clast/clast-registry-lib.bash
-source "$CLAST_LIB/clast-registry-lib.bash"
-# shellcheck source=lib/clast/clast-manifest-lib.bash
-source "$CLAST_LIB/clast-manifest-lib.bash"
-
-# --- Global flag parsing -------------------------------------------------
-#
-# Walk argv before the subcommand name, peeling off any recognized global
-# flag and setting the corresponding env var. Stop at the first non-flag
-# arg (the subcommand) or at `--`. Remaining argv is passed to the
-# subcommand untouched.
-#
-# `--json` and `--journal-dir`/`--projects-dir` are forwarded to the lib
-# via env so subcommands can also accept them locally without re-parsing.
+# shellcheck source=lib/clast/clast-porcelain-lib.bash
+source "$CLAST_LIB/clast-porcelain-lib.bash"
 
 declare -a _CLAST_REMAINING=()
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
     -h|--help|help)
-      clast_usage
+      clast_porcelain_usage
       exit 0
       ;;
     --version)
-      echo "clast $(clast_version)"
+      echo "clast $(clast_porcelain_version)"
       exit 0
       ;;
-    --json)
-      export CLAST_JSON=1
-      shift
-      ;;
-    -v|--verbose)
-      export CLAST_VERBOSE=1
-      shift
-      ;;
-    -q|--quiet)
-      export CLAST_QUIET=1
-      shift
-      ;;
-    --journal-dir)
-      if [[ $# -lt 2 ]]; then
-        clast_log_error "--journal-dir requires a value"
-        exit 2
-      fi
-      export CLAST_JOURNAL_DIR="$2"
-      shift 2
-      ;;
-    --journal-dir=*)
-      export CLAST_JOURNAL_DIR="${1#*=}"
-      shift
-      ;;
-    --projects-dir)
-      if [[ $# -lt 2 ]]; then
-        clast_log_error "--projects-dir requires a value"
-        exit 2
-      fi
-      export CLAST_PROJECTS_DIR="$2"
-      shift 2
-      ;;
-    --projects-dir=*)
-      export CLAST_PROJECTS_DIR="${1#*=}"
-      shift
-      ;;
     --)
       shift
       _CLAST_REMAINING+=("$@")
       break
       ;;
     -*)
-      clast_log_error "unknown global flag: $1"
-      clast_usage >&2
+      clast_porcelain_log_error "unknown global flag: $1"
+      clast_porcelain_usage >&2
       exit 2
       ;;
     *)
-      # First non-flag arg is the subcommand; stop parsing.
       _CLAST_REMAINING+=("$@")
       break
       ;;
@@ -95,7 +44,7 @@ while [[ $# -gt 0 ]]; do
 done
 
 if [[ ${#_CLAST_REMAINING[@]} -eq 0 ]]; then
-  clast_usage
+  clast_porcelain_usage
   exit 0
 fi
 
@@ -103,70 +52,30 @@ set -- "${_CLAST_REMAINING[@]}"
 
 cmd="$1"; shift
 
-# --- Subcommand dispatch -------------------------------------------------
-
-# Map of stubbed subcommands → step number that will implement them.
-# Future steps replace each stub with a real `source` + dispatch below.
-_clast_stub() {
-  local name="$1" step="$2"
-  clast_log_error "$name is not yet implemented (planned for step $step)"
-  exit 2
-}
-
 case "$cmd" in
-  whereami)
-    # shellcheck source=lib/clast/clast-subcommands/whereami.bash
-    source "$CLAST_LIB/clast-subcommands/whereami.bash"
-    clast_cmd_whereami "$@"
-    ;;
-  snapshot)
-    # shellcheck source=lib/clast/clast-subcommands/snapshot.bash
-    source "$CLAST_LIB/clast-subcommands/snapshot.bash"
-    clast_cmd_snapshot "$@"
-    ;;
-  projects)
-    # shellcheck source=lib/clast/clast-subcommands/projects.bash
-    source "$CLAST_LIB/clast-subcommands/projects.bash"
-    clast_cmd_projects "$@"
-    ;;
-  sessions)
-    # shellcheck source=lib/clast/clast-subcommands/sessions.bash
-    source "$CLAST_LIB/clast-subcommands/sessions.bash"
-    clast_cmd_sessions "$@"
-    ;;
-  show)
-    # shellcheck source=lib/clast/clast-subcommands/show.bash
-    source "$CLAST_LIB/clast-subcommands/show.bash"
-    clast_cmd_show "$@"
-    ;;
-  entries)
-    # shellcheck source=lib/clast/clast-subcommands/entries.bash
-    source "$CLAST_LIB/clast-subcommands/entries.bash"
-    clast_cmd_entries "$@"
-    ;;
-  breadcrumb)
-    # shellcheck source=lib/clast/clast-subcommands/breadcrumb.bash
-    source "$CLAST_LIB/clast-subcommands/breadcrumb.bash"
-    clast_cmd_breadcrumb "$@"
+  wake)
+    # shellcheck source=lib/clast/clast-porcelain-subcommands/wake.bash
+    source "$CLAST_LIB/clast-porcelain-subcommands/wake.bash"
+    clast_cmd_wake "$@"
     ;;
-  registry)
-    # shellcheck source=lib/clast/clast-subcommands/registry.bash
-    source "$CLAST_LIB/clast-subcommands/registry.bash"
-    clast_cmd_registry "$@"
+  brief)
+    # shellcheck source=lib/clast/clast-porcelain-subcommands/brief.bash
+    source "$CLAST_LIB/clast-porcelain-subcommands/brief.bash"
+    clast_cmd_brief "$@"
     ;;
-  stats)
-    # shellcheck source=lib/clast/clast-subcommands/stats.bash
-    source "$CLAST_LIB/clast-subcommands/stats.bash"
-    clast_cmd_stats "$@"
+  retro)
+    # shellcheck source=lib/clast/clast-porcelain-subcommands/retro.bash
+    source "$CLAST_LIB/clast-porcelain-subcommands/retro.bash"
+    clast_cmd_retro "$@"
     ;;
-  doctor)
-    # shellcheck source=lib/clast/clast-subcommands/doctor.bash
-    source "$CLAST_LIB/clast-subcommands/doctor.bash"
-    clast_cmd_doctor "$@"
+  undismiss)
+    # shellcheck source=lib/clast/clast-porcelain-subcommands/undismiss.bash
+    source "$CLAST_LIB/clast-porcelain-subcommands/undismiss.bash"
+    clast_cmd_undismiss "$@"
     ;;
   *)
-    clast_log_error "unknown subcommand '$cmd'"
-    clast_usage >&2
+    clast_porcelain_log_error "unknown subcommand '$cmd'"
+    clast_porcelain_usage >&2
     exit 2
     ;;
 esac

package/bin/clast-plumbing

@@ -0,0 +1,180 @@
+#!/usr/bin/env bash
+# clast-plumbing — main dispatcher (the deterministic, LLM-free core).
+#
+# Parses global flags, sources libs, dispatches to a subcommand.
+# Subcommand files live in $CLAST_LIB/clast-subcommands/<name>.bash and
+# each defines a single function `clast_cmd_<name>`. The user-facing
+# porcelain is `bin/clast` (see `clast --help` for that surface).
+set -euo pipefail
+
+CLAST_LIB="${CLAST_LIB:-$(dirname "$(realpath "$0")")/../lib/clast}"
+export CLAST_LIB
+
+# shellcheck source=lib/clast/clast-lib.bash
+source "$CLAST_LIB/clast-lib.bash"
+# shellcheck source=lib/clast/clast-decode-lib.bash
+source "$CLAST_LIB/clast-decode-lib.bash"
+# shellcheck source=lib/clast/clast-registry-lib.bash
+source "$CLAST_LIB/clast-registry-lib.bash"
+# shellcheck source=lib/clast/clast-manifest-lib.bash
+source "$CLAST_LIB/clast-manifest-lib.bash"
+# shellcheck source=lib/clast/clast-classify-lib.bash
+source "$CLAST_LIB/clast-classify-lib.bash"
+
+# --- Global flag parsing -------------------------------------------------
+#
+# Walk argv before the subcommand name, peeling off any recognized global
+# flag and setting the corresponding env var. Stop at the first non-flag
+# arg (the subcommand) or at `--`. Remaining argv is passed to the
+# subcommand untouched.
+#
+# `--json` and `--journal-dir`/`--projects-dir` are forwarded to the lib
+# via env so subcommands can also accept them locally without re-parsing.
+
+declare -a _CLAST_REMAINING=()
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help|help)
+      clast_usage
+      exit 0
+      ;;
+    --version)
+      echo "clast-plumbing $(clast_version)"
+      exit 0
+      ;;
+    --json)
+      export CLAST_JSON=1
+      shift
+      ;;
+    -v|--verbose)
+      export CLAST_VERBOSE=1
+      shift
+      ;;
+    -q|--quiet)
+      export CLAST_QUIET=1
+      shift
+      ;;
+    --journal-dir)
+      if [[ $# -lt 2 ]]; then
+        clast_log_error "--journal-dir requires a value"
+        exit 2
+      fi
+      export CLAST_JOURNAL_DIR="$2"
+      shift 2
+      ;;
+    --journal-dir=*)
+      export CLAST_JOURNAL_DIR="${1#*=}"
+      shift
+      ;;
+    --projects-dir)
+      if [[ $# -lt 2 ]]; then
+        clast_log_error "--projects-dir requires a value"
+        exit 2
+      fi
+      export CLAST_PROJECTS_DIR="$2"
+      shift 2
+      ;;
+    --projects-dir=*)
+      export CLAST_PROJECTS_DIR="${1#*=}"
+      shift
+      ;;
+    --)
+      shift
+      _CLAST_REMAINING+=("$@")
+      break
+      ;;
+    -*)
+      clast_log_error "unknown global flag: $1"
+      clast_usage >&2
+      exit 2
+      ;;
+    *)
+      # First non-flag arg is the subcommand; stop parsing.
+      _CLAST_REMAINING+=("$@")
+      break
+      ;;
+  esac
+done
+
+if [[ ${#_CLAST_REMAINING[@]} -eq 0 ]]; then
+  clast_usage
+  exit 0
+fi
+
+set -- "${_CLAST_REMAINING[@]}"
+
+cmd="$1"; shift
+
+# --- Subcommand dispatch -------------------------------------------------
+
+# Map of stubbed subcommands → step number that will implement them.
+# Future steps replace each stub with a real `source` + dispatch below.
+_clast_stub() {
+  local name="$1" step="$2"
+  clast_log_error "$name is not yet implemented (planned for step $step)"
+  exit 2
+}
+
+case "$cmd" in
+  whereami)
+    # shellcheck source=lib/clast/clast-subcommands/whereami.bash
+    source "$CLAST_LIB/clast-subcommands/whereami.bash"
+    clast_cmd_whereami "$@"
+    ;;
+  snapshot)
+    # shellcheck source=lib/clast/clast-subcommands/snapshot.bash
+    source "$CLAST_LIB/clast-subcommands/snapshot.bash"
+    clast_cmd_snapshot "$@"
+    ;;
+  projects)
+    # shellcheck source=lib/clast/clast-subcommands/projects.bash
+    source "$CLAST_LIB/clast-subcommands/projects.bash"
+    clast_cmd_projects "$@"
+    ;;
+  sessions)
+    # shellcheck source=lib/clast/clast-subcommands/sessions.bash
+    source "$CLAST_LIB/clast-subcommands/sessions.bash"
+    clast_cmd_sessions "$@"
+    ;;
+  show)
+    # shellcheck source=lib/clast/clast-subcommands/show.bash
+    source "$CLAST_LIB/clast-subcommands/show.bash"
+    clast_cmd_show "$@"
+    ;;
+  entries)
+    # shellcheck source=lib/clast/clast-subcommands/entries.bash
+    source "$CLAST_LIB/clast-subcommands/entries.bash"
+    clast_cmd_entries "$@"
+    ;;
+  breadcrumb)
+    # shellcheck source=lib/clast/clast-subcommands/breadcrumb.bash
+    source "$CLAST_LIB/clast-subcommands/breadcrumb.bash"
+    clast_cmd_breadcrumb "$@"
+    ;;
+  registry)
+    # shellcheck source=lib/clast/clast-subcommands/registry.bash
+    source "$CLAST_LIB/clast-subcommands/registry.bash"
+    clast_cmd_registry "$@"
+    ;;
+  stats)
+    # shellcheck source=lib/clast/clast-subcommands/stats.bash
+    source "$CLAST_LIB/clast-subcommands/stats.bash"
+    clast_cmd_stats "$@"
+    ;;
+  doctor)
+    # shellcheck source=lib/clast/clast-subcommands/doctor.bash
+    source "$CLAST_LIB/clast-subcommands/doctor.bash"
+    clast_cmd_doctor "$@"
+    ;;
+  retro)
+    # shellcheck source=lib/clast/clast-subcommands/retro.bash
+    source "$CLAST_LIB/clast-subcommands/retro.bash"
+    clast_cmd_retro "$@"
+    ;;
+  *)
+    clast_log_error "unknown subcommand '$cmd'"
+    clast_usage >&2
+    exit 2
+    ;;
+esac

package/examples/cron/clast-snapshot.service

@@ -3,8 +3,8 @@
 # then enable the timer with: systemctl --user enable --now clast-snapshot.timer
 
 [Unit]
-Description=Capture Claude Code transcripts with clast
+Description=Capture Claude Code transcripts with clast-plumbing
 
 [Service]
 Type=oneshot
-ExecStart=/usr/local/bin/clast snapshot
+ExecStart=/usr/local/bin/clast-plumbing snapshot

package/examples/cron/clast-snapshot.timer

@@ -3,7 +3,7 @@
 # systemctl --user enable --now clast-snapshot.timer
 
 [Unit]
-Description=Run clast snapshot hourly
+Description=Run clast-plumbing snapshot hourly
 
 [Timer]
 OnBootSec=5min

package/examples/cron/crontab.sample

@@ -1,16 +1,16 @@
 # clast cron sample for unattended transcript capture.
 # Install with: crontab -l | { cat; cat examples/cron/crontab.sample; } | crontab -
-# Edit the clast path if you installed somewhere other than /usr/local/bin.
+# Edit the clast-plumbing path if you installed somewhere other than /usr/local/bin.
 
 # Every hour at :05, capture any new transcripts.
 # Idempotent and silent on no-op, so safe to run frequently.
-5 * * * * /usr/local/bin/clast snapshot >/dev/null 2>&1
+5 * * * * /usr/local/bin/clast-plumbing snapshot >/dev/null 2>&1
 
 # Alternative: every 15 minutes for active users moving between many sessions.
-# */15 * * * * /usr/local/bin/clast snapshot >/dev/null 2>&1
+# */15 * * * * /usr/local/bin/clast-plumbing snapshot >/dev/null 2>&1
 
 # Alternative: once daily for hands-off archival.
-# 10 4 * * * /usr/local/bin/clast snapshot >/dev/null 2>&1
+# 10 4 * * * /usr/local/bin/clast-plumbing snapshot >/dev/null 2>&1
 
 # Alternative: no cron. Rely on the SessionStart hook installed with the plugin.
 # The hook covers most use cases already; cron is only useful when you want capture without ever opening Claude.

package/examples/workflows/morning-briefing.md

@@ -1,13 +1,13 @@
 # Morning Briefing Example
 
-This is a realistic walkthrough of one `/day-wakeup` run. Yesterday, `xesapps`
+This is a realistic walkthrough of one `/wake` run. Yesterday, `xesapps`
 finished a field-normalization fix, `notes` explored a journal template update,
 and `infra-tools` checked a flaky shell lint issue.
 
 ```bash
-# User: /day-wakeup
-clast snapshot
-clast --json sessions --day yesterday
+# User: /wake
+clast-plumbing snapshot
+clast-plumbing --json sessions --day yesterday
 ```
 
 It filters to `curated: false`, groups by project, and shows:
@@ -23,8 +23,8 @@ xesapps      09:12  feature/field-normalize  58 messages
 The skill reads session details and breadcrumbs:
 
 ```bash
-clast --json show 33333333-3333-4333-8333-333333333333 --full --turns 8
-clast breadcrumb --read --project infra-tools --day yesterday
+clast-plumbing --json show 33333333-3333-4333-8333-333333333333 --full --turns 8
+clast-plumbing breadcrumb --read --project infra-tools --day yesterday
 ```
 
 It drafts a short entry:
@@ -43,15 +43,15 @@ AskUserQuestion presents `Accept`, `Accept + promote decision`, `Accept + promot
 common-issue`, `Accept + promote workflow`, `Edit`, `Skip`, and `Stop here`.
 
 The user chooses `Skip`. The skill writes nothing; the session remains
-uncurated and can be revisited in a later `/day-wakeup`.
+uncurated and can be revisited in a later `/wake`.
 
 ## Session 2: notes
 
 The skill reads the next transcript:
 
 ```bash
-clast --json show 22222222-2222-4222-8222-222222222222 --full --turns 8
-clast breadcrumb --read --project notes --day yesterday
+clast-plumbing --json show 22222222-2222-4222-8222-222222222222 --full --turns 8
+clast-plumbing breadcrumb --read --project notes --day yesterday
 ```
 
 The user asks for a revision:
@@ -76,7 +76,7 @@ Tighten the note-entry template before using it for project briefings.
 The skill writes through stdin:
 
 ```bash
-clast entries write \
+clast-plumbing entries write \
   --session 22222222-2222-4222-8222-222222222222 \
   --slug entry-template-cleanup \
   --tags notes,template \
@@ -89,8 +89,8 @@ clast entries write \
 The skill reads the session and breadcrumbs:
 
 ```bash
-clast --json show 11111111-1111-4111-8111-111111111111 --full --turns 8
-clast breadcrumb --read --project xesapps --day yesterday
+clast-plumbing --json show 11111111-1111-4111-8111-111111111111 --full --turns 8
+clast-plumbing breadcrumb --read --project xesapps --day yesterday
 ```
 
 The user chooses `Accept + promote decision` for this draft:
@@ -112,7 +112,7 @@ items are folded into the entry body rather than written to separate decision,
 common-issue, or workflow files.
 
 ```bash
-clast entries write \
+clast-plumbing entries write \
   --session 11111111-1111-4111-8111-111111111111 \
   --slug field-normalization-fix \
   --tags xesapps,fields,regression \
@@ -123,15 +123,15 @@ clast entries write \
 Final summary:
 
 ```text
-Day wakeup complete.
+Wake complete.
 Curated: 2 sessions across 2 projects.
 Skipped: 1 session.
 Remaining uncurated: 1.
 Promoted: 1 decision (folded into the accepted entry for v1.0).
-Run `/wakeup <project>` to start working on a specific project today.
+Run `/brief <project>` to start working on a specific project today.
 ```
 
 What this changes on disk:
 `entries/2026-05-31-1340-notes-entry-template-cleanup.md` and `entries/2026-05-31-0912-xesapps-field-normalization-fix.md` were written.
-`.manifest.jsonl` was already current from `clast snapshot`; curation does not append to it.
-The skipped `infra-tools` session stays uncurated and remains eligible for a later `/day-wakeup`.
+`.manifest.jsonl` was already current from `clast-plumbing snapshot`; curation does not append to it.
+The skipped `infra-tools` session stays uncurated and remains eligible for a later `/wake`.