{
  "description": "Print a usage and cost report for AI coding tools over a period or date range, optionally as JSON. The optimize, guard, sync, quota and other subcommands are not modelled.",
  "name": "codeburn",
  "subcommands": [
    {
      "name": "report",
      "description": "Report spend and usage; --format json prints the full dashboard data to stdout.",
      "options": [
        {
          "names": [
            "-p"
          ],
          "description": "Period",
          "args": {
            "name": "period",
            "isOptional": false,
            "suggestions": [
              {
                "name": "today",
                "description": "Today"
              },
              {
                "name": "week",
                "description": "Last 7 days"
              },
              {
                "name": "30days",
                "description": "Last 30 days"
              },
              {
                "name": "month",
                "description": "This month"
              },
              {
                "name": "all",
                "description": "All recent"
              },
              {
                "name": "lifetime",
                "description": "Lifetime"
              }
            ]
          }
        },
        {
          "names": [
            "--from"
          ],
          "description": "YYYY-MM-DD.",
          "args": {
            "name": "from",
            "description": "YYYY-MM-DD.",
            "isOptional": false
          }
        },
        {
          "names": [
            "--to"
          ],
          "description": "YYYY-MM-DD.",
          "args": {
            "name": "to",
            "description": "YYYY-MM-DD.",
            "isOptional": false
          }
        },
        {
          "names": [
            "--format"
          ],
          "description": "Output format",
          "args": {
            "name": "format",
            "isOptional": false,
            "suggestions": [
              {
                "name": "json",
                "description": "JSON"
              }
            ]
          }
        },
        {
          "names": [
            "--provider"
          ],
          "description": "Provider",
          "args": {
            "name": "provider",
            "isOptional": false,
            "suggestions": [
              {
                "name": "claude",
                "description": "Claude Code"
              }
            ]
          }
        },
        {
          "names": [
            "--project"
          ],
          "description": "Only projects matching",
          "args": {
            "name": "project",
            "isOptional": false,
            "isVariadic": true
          },
          "isRepeatable": true
        },
        {
          "names": [
            "--exclude"
          ],
          "description": "Exclude projects matching",
          "args": {
            "name": "exclude",
            "isOptional": false,
            "isVariadic": true
          },
          "isRepeatable": true
        }
      ]
    }
  ]
}