| name | hooks |
| description | Manage idev's optional hooks without editing settings — show status, enable/disable the auto-learning observer and compact suggester, and install the team git commit hooks. |
$idev:hooks — Hook Manager
Manage the plugin's optional hooks. They are pre-registered in the plugin's
hooks/hooks.json but off by default — each script exits instantly unless
its opt-in flag exists. Toggling a flag takes effect immediately (no restart,
no settings.json editing).
Arguments: $ARGUMENTS
The toggles
| Hook | Flag file | Scope |
|---|
observer (auto-learning capture) | ~/.codex/homunculus/enabled | global, all projects |
compact (/compact suggestions) | <project>/.codex/idev/compact-suggestions-enabled | per project |
Subcommands
status (default when no arguments)
Check both flag files and report each hook as ENABLED/DISABLED, plus:
- observer: number of lines in
~/.codex/homunculus/observations.jsonl if present, and whether the background analyzer is running (bash "${PLUGIN_ROOT}/skills/auto-learning/agents/start-observer.sh" status)
- compact: current counter value for this session's file in the temp dir, threshold (
IDEV_COMPACT_THRESHOLD, default 50)
- git hooks: whether
.git/hooks/commit-msg and .git/hooks/prepare-commit-msg are the idev versions (check for the # idev marker line)
enable observer / disable observer
mkdir -p ~/.codex/homunculus && touch ~/.codex/homunculus/enabled
rm -f ~/.codex/homunculus/enabled
On enable, remind the user: observations capture tool inputs/outputs
(secret-redacted) to ~/.codex/homunculus/; tools can be filtered via the
plugin's skills/auto-learning/config.json.
enable compact / disable compact
mkdir -p .codex/idev && touch .codex/idev/compact-suggestions-enabled
rm -f .codex/idev/compact-suggestions-enabled
Run from the project root. Requires .codex/idev/ (run $idev:idev-init first).
install-git-hooks
Installs the team commit-message hooks into the current repo:
- Verify this is a git repo (
git rev-parse --git-dir); find the hooks dir
(respect core.hooksPath if set).
- For each of
prepare-commit-msg and commit-msg: if a hook already exists
and is NOT an idev hook (no # idev marker), do not overwrite — show the
user both and ask how to proceed (chain it, replace it, or skip).
- Copy from
${PLUGIN_ROOT}/templates/git-hooks/ and chmod +x both.
- If
.codex/idev/commit-style.md doesn't exist, copy
${PLUGIN_ROOT}/templates/commit-style.md there and tell the user to
tune it (it's the source of truth the commit-style skill reads).
- Remind: git hooks are per-clone — teammates run
$idev:hooks install-git-hooks
too, or the team commits the hooks dir and sets core.hooksPath.
After any change
Report the new state of all toggles (a compact status table).
