Hooks
What subrosa runs automatically, and when. A hook is a command Claude Code fires at a fixed moment, without you asking for it.
$ npx -y skills add ij5a/subrosa --agent claude-codeShips with subrosa. Installing the plugin gets these hooks.
What fires, and when
SessionStart
Fires once when a session begins, and again after a context compaction. It is where a plugin sets up its environment, or restores state the compaction dropped.
- Runs session-start.
SessionEnd
- Runs session-end.
UserPromptSubmit
Fires before Claude sees each prompt you send. A plugin can use it to inject context, so the same instruction reaches the model every turn instead of only at session start.
- Runs user-prompt-submit.
PreCompact
- Runs pre-compact.
Stop
- Runs stop.
Where it lives
- hooks/run.shGitHub
Read the script before you install anything that runs on your machine. This is the one part of a plugin that acts without being asked.
Persistent, private memory for Claude Code โ every session archived locally, searchable. Sub rosa.
Repo: ij5a/subrosa

