Hooks

Hooks let you run shell commands automatically when simse invokes specific tools. They are defined per-plugin in a hooks.toml file inside the plugin's directory.

Configuration

Each hook is a top-level entry in <plugin-dir>/hooks.toml with two fields:

matcher = "fs_write|fs_edit"
command = "${PLUGIN_ROOT}/format.sh"

Fields

• matcher — Pattern to match against tool names. Use | to match multiple tools.
• command — Shell command to run when a matching tool is called. ${PLUGIN_ROOT} is replaced with the plugin's directory path.

That's it. No other fields or variables.

Example: format on save

A plugin that auto-formats files whenever simse writes or edits them:

my-plugin/
  hooks.toml
  format.sh

hooks.toml:

matcher = "fs_write|fs_edit"
command = "${PLUGIN_ROOT}/format.sh"

format.sh:

#!/usr/bin/env bash
prettier --write .

When simse calls fs_write or fs_edit, the hook fires and runs format.sh from the plugin directory.

How it works

1. simse checks all loaded plugins for hooks.toml files.
2. When a tool is called, the tool name is matched against each hook's matcher pattern.
3. If the pattern matches, the hook's command is executed with ${PLUGIN_ROOT} expanded to the plugin's directory path.