journal

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:

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, decision) and any obvious tags; when unclear, leave type empty. Then call:

mcp__plugin_br8n_br8n__br8n_journal(text, type, tags, title, project, project_path)

• text — the entry (required).
• type / tags — your inferred label + keywords (optional).
• project / project_path — the resolved repo context, if any (optional).

On success it returns {finding_id, entry_path, scope}. Confirm briefly: echo the one-line title and the type, e.g. "Journaled (decision): prefer scope filters over separate corpora." Do not paste the whole entry back.