{
  "id": "carl",
  "name": "carl",
  "homepage": "https://codeberg.org/birger/carl",
  "description": "Calendar for the command-line.",
  "executables": [
    "carl"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/.carl/config.toml",
      "[configHome]/.carl/*.theme"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Show calendar",
    "description": "Print a calendar for the current month, a year or a given date. Themes and ical files are set in the config file, not here.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": true
    },
    "source": [
      {
        "id": "readme",
        "kind": "manual",
        "url": "https://codeberg.org/birger/carl",
        "revision": "2026-10-27",
        "evidence": "- **-1**, **--one**: Display single month output.  (This is the default.)\n- **-3**, **--three**: Display prev/current/next month output.\n- **-n**, **--months NUMBER**: Display current and following months.\n- **-s**, **--sunday**: Display Sunday as the first day of the week.\n- **-m**, **--monday**: Display Monday as the first day of the week.\n- **-j**, **--julian**: Display Julian dates (days one-based, numbered from January 1).\n- **-y**, **--year**: Display a calendar for the current year.\n- **-a**, **--agenda**: Display agenda (a listing of all the events that occur in the the displayed calendar timespan) below the calendar\n- **YYYY**: Display the current date from the given year\n- **MM YYYYY**: Display the given month in the given year\n- **DD MM YYYY**: Display the given date\n"
      }
    ],
    "field": [
      {
        "id": "three",
        "label": "Three months",
        "description": "Previous, current and next month.",
        "type": "boolean",
        "option": [
          "--three",
          "-3"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "months",
        "label": "Number of months",
        "type": "integer",
        "option": [
          "--months",
          "-n"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "year_view",
        "label": "Whole current year",
        "type": "boolean",
        "option": [
          "--year",
          "-y"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "sunday",
        "label": "Sunday first",
        "type": "boolean",
        "option": [
          "--sunday",
          "-s"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "monday",
        "label": "Monday first",
        "type": "boolean",
        "option": [
          "--monday",
          "-m"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "julian",
        "label": "Julian dates",
        "type": "boolean",
        "option": [
          "--julian",
          "-j"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "agenda",
        "label": "Show agenda",
        "type": "boolean",
        "option": [
          "--agenda",
          "-a"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "date",
        "label": "Date",
        "description": "YYYY, MM YYYY or DD MM YYYY, as separate words. Leave empty for today.",
        "type": "string",
        "position": 0,
        "multiple": true,
        "sources": [
          "readme"
        ]
      }
    ],
    "task": [
      {
        "id": "three-months",
        "label": "Three-month view",
        "fields": [
          "three",
          "monday",
          "agenda"
        ],
        "required": [
          "three"
        ],
        "set": {
          "three": [
            true
          ]
        }
      },
      {
        "id": "year",
        "label": "Year calendar",
        "fields": [
          "year_view",
          "monday",
          "julian"
        ],
        "required": [
          "year_view"
        ],
        "set": {
          "year_view": [
            true
          ]
        }
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "date",
          "three",
          "months",
          "year_view",
          "agenda"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "sunday",
          "monday",
          "julian"
        ]
      }
    ]
  }
}