felinics Hooks Setup
Use this skill when the user wants to inspect, create, update, debug, or explain Memoh hooks.
Files
- User hooks live at
/data/.memoh/hooks.json. - Detailed schema, events, payloads, and examples live in
references/reference.md.
Read references/reference.md before adding anything beyond an empty config or a simple logging hook.
Empty Config
If /data/.memoh/hooks.json is missing, create:
{
"version": 1,
"enabled": true,
"hooks": []
}
Minimal Workflow
- Read
/data/.memoh/hooks.json. - Preserve existing hooks unless the user asks to replace them.
- Choose the narrowest event and matcher.
- Prefer logging hooks with
on_error: "ignore". - Use
on_error: "block"only for guardrail hooks that should deny on failure. - Validate JSON syntax before finishing.
Common Pattern
{
"version": 1,
"enabled": true,
"defaults": {
"timeout": "10s",
"on_error": "fail",
"max_output_bytes": 65536,
"trigger_nested_hooks": false
},
"env": {},
"hooks": [
{
"name": "log workspace commands",
"event": "AfterWorkspaceCommand",
"enabled": true,
"priority": 10,
"matcher": ".*",
"actions": [
{
"type": "command",
"command": "mkdir -p .memoh && cat >> .memoh/hooks.log",
"on_error": "ignore"
}
]
}
]
}
Action Output
Command and tool actions may return:
{
"decision": "allow",
"reason": "optional explanation",
"append_context": "optional context"
}
Allowed decisions are allow, deny, ask_approval, and append_context.
For full examples and the complete event catalog, read references/reference.md.