journallisted

# br8n — Journal (cross-project, write-anytime, searchable) The journal is your **global notebook**, separate from session notes. Session notes are bound to the current repo+branch and written automatically at session end; a journal entry is written **whenever you choose** and is **searchable across every project**. Both live in the same `~/.br8n/brain.db`; the journal just uses a reserved, repo-independent scope. ## Step 0 — Resolve optional context The journal itself is global, so a write needs no project. But it's useful to stamp **where you were** when you journaled, and `scope=project|both` searches need the current repo+branch: ```bash basename "$(git rev-parse --show-toplevel)" # project (optional context) git branch --show-current # kb git rev-parse --show-toplevel # project_path ``` If not in a git repo, omit them (writes still work; `scope=project` is then N/A). ## Mode select — branch on the args | Invocation | Mode | Do | |---|---|---| | `/br8n:journal <text>` | **Write** | Step A — save an entry | | `/br8n:journal search <query> [--scope both\|journal\|project] [--type T]` | **Search** | Step B — recall by meaning | | `/br8n:journal recent [N]` | **Recent** | Step C — list latest entries | If the first arg is `search` or `recent`, use that mode; otherwise treat the whole input as the text to journal. ## Step A — Write an entry From the user's text, infer a `type` (one of `insight`, `reflection`, `reference`, `decisi