mkdocs.yml

site_name: td — AI-Native Todoist CLI
site_description: A modern Todoist CLI built for both humans and AI agents
site_url: https://craigmccaskill.github.io/todoist-cli/
repo_url: https://github.com/craigmccaskill/todoist-cli
repo_name: craigmccaskill/todoist-cli

theme:
  name: material
  palette:
    - scheme: slate
      primary: deep purple
      accent: amber
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
    - scheme: default
      primary: deep purple
      accent: amber
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
  features:
    - navigation.instant
    - navigation.sections
    - navigation.expand
    - content.code.copy
    - search.suggest
  icon:
    repo: fontawesome/brands/github

nav:
  - Home: index.md
  - Getting Started:
    - Installation: getting-started/install.md
    - Quick Start: getting-started/quickstart.md
    - Configuration: getting-started/config.md
  - Commands:
    - Overview: commands/index.md
    - Task Management: commands/tasks.md
    - Organization: commands/organization.md
    - Workflow: commands/workflow.md
    - Utilities: commands/utilities.md
  - AI & Agent Integration:
    - Overview: ai/index.md
    - Structured Output: ai/output.md
    - Error Handling: ai/errors.md
    - Idempotency: ai/idempotency.md
  - Design Decisions:
    - Overview: decisions/README.md
    - "ADR-0001: Design Principle": decisions/0001-design-principle.md
    - "ADR-0002: Output Envelope": decisions/0002-output-envelope.md
    - "ADR-0003: Priority Mapping": decisions/0003-priority-mapping.md
    - "ADR-0004: Task Reference Resolution": decisions/0004-task-ref-resolution.md
    - "ADR-0005: Import Boundary": decisions/0005-core-cli-boundary.md
    - "ADR-0006: Schema as AI Contract": decisions/0006-schema-as-ai-contract.md
    - "ADR-0007: Cache TTLs": decisions/0007-row-number-cache-ttl.md
    - "ADR-0008: Click over Typer": decisions/0008-click-over-typer.md
    - "ADR-0009: CRUD Verb Grammar": decisions/0009-crud-verb-grammar.md
    - "ADR-0010: Triage Framework": decisions/0010-triage-framework.md
    - "ADR-0011: Dependency Tracking": decisions/0011-dependency-tracking.md
    - "ADR-0012: Browse Command": decisions/0012-browse-command.md
  - Contributing: contributing.md

markdown_extensions:
  - admonition
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.details
  - attr_list
  - md_in_html
  - toc:
      permalink: true