symposium hook
Entry point invoked by your agent’s hook system. This is an internal command; you generally don’t need to run it yourself.
Usage
symposium hook <AGENT> <EVENT>
Behavior
When your agent triggers a hook event, it calls symposium hook with the agent name and event type. The hook does two things:
-
Auto-sync (if enabled): when
auto-sync = truein the user config, runssymposium syncto ensure skills are current for the workspace. The workspace root is resolved from the hook payload’scwdfield; if the payload does not include a working directory, the process’s current working directory is used as a fallback. Failures are logged but don’t block hook dispatch. -
Dispatches to plugin hooks: runs any hook handlers defined by plugins for the given event.
Output
Stdout carries only the response for your agent, in its own format. Sync progress goes to the log file, and whatever a plugin’s install_commands print goes to stderr. To see the progress when running a hook by hand, pass -v: symposium -v hook <AGENT> <EVENT> prints it to stderr.
Events
The specific events depend on which agent you are using. symposium init configures the hook registration appropriate for your agents.
When is the hook invoked?
The hook is registered globally during symposium init. It runs automatically when your agent triggers supported events (e.g., session start, tool use).