Claude Code forgets
everything.

Detects the OS-specific Obsidian path and launches the app if it is not running, polling until the vault CLI responds; a clean no-op when Obsidian is already up.

On a post-compaction SessionStart, re-injects the critical context captured by the pre-compact snapshot so work survives compaction.

In a recognized code project, finds or auto-creates the session note under 2. Areas/Sessions/<Project>/, detects the git branch, and injects the active note plus recent transcript context.

Regenerates the Brainy settings + usage-analytics dashboard HTML without blocking session start.

In a genuine code project, nudges to initialize beads (auto-runs `bd init` when .beads is missing); stays completely silent in a vault / non-code session.

Surfaces the ready / in-progress beads queue (and a TUI banner) at session start for a genuine code session only.

Detects whether the project has git and guides initialization, degrading gracefully when git is absent rather than failing.

Nudges toward the recommended testing stack when no test setup is present; silent once testing is configured.

Blocks pushes to main/master before they happen, enforcing the branch-first workflow.

if: Bash(git push *)

Blocks pushes to main/master before they happen, enforcing the branch-first workflow.

if: Bash(git commit *)

Blocks pushes to main/master before they happen, enforcing the branch-first workflow.

if: Bash(git checkout *)

Blocks pushes to main/master before they happen, enforcing the branch-first workflow.

if: Bash(git switch *)

Validates the branch name against the feature/ fix/ chore/ convention when pushing.

if: Bash(git push *)

Finalizes and closes the session at SessionEnd as part of the session lifecycle.

Injects the persistent-memory reminder so prior sessions and vault knowledge are searched before the model assumes or guesses.

Reminds the agent to track code work in beads whenever a codebase is present at or above the cwd.

Auto-updates the active session note on stop, extracting goal and outcome from the transcript.

Exports the session transcript to an Obsidian markdown recap and re-indexes it in QMD.

Verifies the session note was updated and nudges if progress or decisions were not logged.

Checks for open / in-progress beads issues at stop and reminds to close completed work.

Checks for unfinished tracked tasks before the turn ends.

Snapshots critical context (goal, decisions, open work) before compaction so it can be restored afterward.

Reinjects the pre-compact snapshot after compaction so the agent keeps its working context.

Keeps the MEMORY.md index in sync whenever a memory file is written.

Nudges to append progress and decisions to the active session note after meaningful work.

Updates the status-line state with current session and beads information.

After a beads issue is closed, nudges to commit at a healthy cadence.

if: Bash(bd close *) || Bash(bd update * --status closed)

When a beads issue is claimed, creates or switches to a matching feature branch.

if: Bash(bd update * --claim) || Bash(bd claim *)

Mirrors beads state changes into TaskNotes in the vault so tasks stay three-way synced.

if: Bash(bd *)

Emits a reminder to mirror the bd state change into the live todo list the user sees.

if: Bash(bd create *) || Bash(bd update * --claim) || Bash(bd update * --status *) || Bash(bd close *)

Refreshes the beads dashboard after any bd command.

if: Bash(bd *)

Syncs TaskNotes (mtn) completions back into beads to close the task-mirror loop.

if: Bash(mtn complete *) || Bash(mtn done *)

Reconciles a newly created Claude Code task with beads tracking.

Reconciles a completed Claude Code task with its corresponding beads issue.