KodaCode
Coming soon
Docs/Settings

Hooks

Commands Koda runs at points in a session: before and after a tool, when a prompt arrives, when a turn ends. Written in the hooks.json format Codex and Claude Code use.

Hooks

Yours apply to every project. A project can add its own in .koda/hooks.json.

Hooks

Approve project hooks, and switch hooks off everywhere or in this project.

How hooks are approved

Your hooks in ~/.config/kc/hooks.json run in every project. A project's hooks in .koda/hooks.json run only after you approve them. After each change to them, you approve them again. Changes apply from the next turn.

Each hook shows one of these states:

  • Waiting for your approval.
  • Changed since you approved it.
  • Off in every project.
  • Off in this project.
  • Approved.
  • On.

Approve, Turn off everywhere and Turn off here change the state. KodaCode saves these choices as hooks_trusted and hooks_disabled in config.toml. See Files & folders for the events.