{
  "name": "mailkit",
  "title": "mailkit user guide",
  "version": "0.4.0",
  "updated": "2026-08-20",
  "audience": ["agents", "humans"],
  "purpose": "How to use mailkit 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 mailkit is, the one send rule, how to load this guide.",
      "topics": ["overview", "guardrails"]
    },
    {
      "id": "setup",
      "title": "Configure accounts",
      "path": "setup.md",
      "summary": "After install: Gmail OAuth client, Fastmail API token, Proton Mail Bridge.",
      "topics": ["setup", "auth", "gmail", "fastmail", "protonmail"]
    },
    {
      "id": "accounts",
      "title": "Accounts",
      "path": "accounts.md",
      "summary": "List, default, switch, doctor, remove. --account flag.",
      "topics": ["auth", "multi-account"]
    },
    {
      "id": "providers",
      "title": "Providers",
      "path": "providers.md",
      "summary": "Which verbs work on Gmail, Fastmail, and Proton Mail.",
      "topics": ["gmail", "fastmail", "protonmail"]
    },
    {
      "id": "read",
      "title": "Read mail",
      "path": "read.md",
      "summary": "read, search, show, thread. Query syntax per provider.",
      "topics": ["read"]
    },
    {
      "id": "write",
      "title": "Draft, reply, send",
      "path": "write.md",
      "summary": "Drafts never send. send always needs --yes plus human confirmation.",
      "topics": ["draft", "send", "guardrails"]
    },
    {
      "id": "organize",
      "title": "Organize",
      "path": "organize.md",
      "summary": "Label, archive, read-state, trash. Ids or -q.",
      "topics": ["organize"]
    },
    {
      "id": "filters",
      "title": "Filters and filing",
      "path": "filters.md",
      "summary": "Gmail server-side filters, reconcile, file-inbox. Gmail-only.",
      "topics": ["filters", "gmail"]
    },
    {
      "id": "json",
      "title": "JSON output",
      "path": "json.md",
      "summary": "Shapes for --json. Always use --json when parsing.",
      "topics": ["json", "agents"]
    },
    {
      "id": "agents",
      "title": "For agents",
      "path": "agents.md",
      "summary": "Operating procedure: confirm send, never put secrets on argv, pick provider verbs.",
      "topics": ["agents", "guardrails"]
    },
    {
      "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.4.0.",
      "topics": ["reference"]
    }
  ],
  "related_json": ["commands.json"]
}