← All hooks

Checkpoint Tick

non-blocking stable

30-minute background tick that writes a HANDOFF.md so context-window resets don't lose state. Implements Common.md §U10 (handoff + checkpoint) and §U13 (context-window discipline). If more than 30 minutes have elapsed since the last tick, invokes the /checkpoint skill or emits a minimal HANDOFF.md template at cwd. Updates the timestamp on every run.

ID hook/checkpoint-tick Version 1.0.0 Author convergent-systems-key
ai hooks run checkpoint-tick
Event Stop Language python Trigger always Side effects
  • writes HANDOFF.md at cwd
  • updates ~/.config/aiConstitution/checkpoints/<project>/.last-tick
linuxmacoswindows Logic is cross-platform. Wiring: use 'ai hooks run checkpoint-tick' in settings.json — the ai binary discovers Python on each OS. Already contains sys.platform == 'win32' logic for config dir (%APPDATA%\aiConstitution on Windows).
checkpointhandoffcontext-windowcontinuityclaude-code
Attribution: convergent-systems-key.