{
  "name": "calkit",
  "title": "calkit user guide",
  "version": "0.3.0",
  "updated": "2026-08-20",
  "audience": ["agents", "humans"],
  "purpose": "How to use calkit after it is installed. Not a codebase map.",
  "load_first": ["llms.txt", "start-here.md"],
  "base": "docs/use",
  "pages": [
    {
      "id": "start-here",
      "title": "Start here",
      "path": "start-here.md",
      "summary": "What calkit is, the JSON envelope, work inside a calendar repo.",
      "topics": ["overview"]
    },
    {
      "id": "setup",
      "title": "Set up a calendar",
      "path": "setup.md",
      "summary": "init, repo layout, doctor, schema.",
      "topics": ["setup"]
    },
    {
      "id": "events",
      "title": "Events",
      "path": "events.md",
      "summary": "add, edit, show, rm, mv. Flags for time, location, alerts.",
      "topics": ["events"]
    },
    {
      "id": "agenda",
      "title": "Agenda and lists",
      "path": "agenda.md",
      "summary": "list, agenda, next. Date tokens. Expand recurrence on read.",
      "topics": ["read"]
    },
    {
      "id": "scopes",
      "title": "Scopes",
      "path": "scopes.md",
      "summary": "Scope tracks (personal, business, …). list/add/edit/rm.",
      "topics": ["scopes"]
    },
    {
      "id": "recurrence",
      "title": "Recurrence",
      "path": "recurrence.md",
      "summary": "RFC 5545 RRULE, helpers, until/count, expansion.",
      "topics": ["recurrence"]
    },
    {
      "id": "ical",
      "title": "Import, export, feeds",
      "path": "ical.md",
      "summary": "ics/json import-export, localhost subscription feeds.",
      "topics": ["ical"]
    },
    {
      "id": "reminders",
      "title": "Reminders",
      "path": "reminders.md",
      "summary": "Event alerts, reminder items, the local cron.",
      "topics": ["reminders"]
    },
    {
      "id": "git",
      "title": "Snapshots and history",
      "path": "git.md",
      "summary": "snapshot, history, revert, branch. Mutations do not commit.",
      "topics": ["git"]
    },
    {
      "id": "json",
      "title": "JSON output",
      "path": "json.md",
      "summary": "{ok,data|error} envelope. Always pass --json.",
      "topics": ["json", "agents"]
    },
    {
      "id": "agents",
      "title": "For agents",
      "path": "agents.md",
      "summary": "Operating procedure: schema first, --json always, never push.",
      "topics": ["agents"]
    },
    {
      "id": "troubleshooting",
      "title": "Troubleshooting",
      "path": "troubleshooting.md",
      "summary": "Common errors and what to run.",
      "topics": ["troubleshooting"]
    },
    {
      "id": "reference",
      "title": "Command reference",
      "path": "reference.md",
      "summary": "Every command and flag, current as of 0.3.0.",
      "topics": ["reference"]
    }
  ],
  "related_json": ["commands.json"]
}