Point your agent at this folder (docs/use/) or the public site. Load llms.txt, then catalog.json and commands.json. calkit init-skill installs a skill into .claude/skills/calkit. This user guide is the public, versioned source. Prefer it when both exist.

​
Operating loop

  1. calkit --version — this guide matches 0.3.0.
  2. calkit doctor --json — if NOT_FOUND, init (ask where) or cd into the calendar.
  3. calkit schema --json before inventing fields.
  4. calkit scope list --json then agenda / next.
  5. Mutate with --json. Show the human the result. snapshot only when they want a checkpoint.
  6. Never git push unless they asked.

​
Always --json

If you forget, you will scrape tables and break. Set CALKIT_JSON=1 for the session if the harness allows.

​
Do not

  • Guess RRULE syntax when schema + helpers will do.
  • Hand-edit scope in YAML to move an event (calkit mv).
  • Fire remind --due as a one-off experiment; use remind --dry-run or reminders test.
  • Wire reminders to message third parties. Owner channel only.
  • Commit with raw git when calkit snapshot exists — unless the human asked for a git-level operation.

​
Public URLs