Skip to main content

fased hooks

Manage local lifecycle hooks from the CLI. Browser equivalent: Extensions > Hooks. Agent memory controls live in Agent > Memory. Related:

Inspect hooks

fased hooks list
fased hooks list --eligible
fased hooks list --verbose
fased hooks list --json
fased hooks info session-memory
fased hooks check
list shows discovered hooks from workspace, managed, and bundled sources. check summarizes eligibility.

Enable or disable

fased hooks enable session-memory
fased hooks disable command-logger
Restart the gateway after changing enabled hook code if the UI or CLI says the runtime has not reloaded. Plugin-owned hooks may show as plugin:<id>. Enable or disable the plugin instead of editing those hooks directly.

Install hook packs

fased hooks install ./my-hook-pack
fased hooks install ./my-hook-pack.zip
fased hooks install @fased/my-hook-pack
fased hooks install -l ./my-hook-pack
fased hooks install @fased/my-hook-pack --pin
Rules:
  • npm specs are registry-only
  • local folders and archives are supported for operator-controlled installs
  • Git, URL, and arbitrary remote specs are rejected
  • dependency installs run with --ignore-scripts
  • --pin records npm installs as an exact resolved package version
Update npm-backed hook packs:
fased hooks update <id>
fased hooks update --all
fased hooks update --all --dry-run

Bundled hooks

HookPurpose
session-memorySaves session context to memory when /new or /reset runs.
bootstrap-extra-filesAdds extra workspace files during Agent bootstrap.
command-loggerWrites command events to ~/.fased/logs/commands.log.
boot-mdRuns BOOT.md when the gateway starts.

Review rule

Hooks are executable code inside the gateway. Review hook source and dependency trees before enabling third-party hook packs.