{
  "id": "aicommits",
  "name": "AI Commits",
  "homepage": "https://github.com/Nutlope/aicommits",
  "description": "A CLI that writes your git commit messages for you with AI.",
  "executables": [
    "aicommits"
  ],
  "dotfiles": {
    "paths": [],
    "secret": [
      "~/.aicommits"
    ]
  },
  "commands": {
    "format": 1,
    "label": "Generate commit message",
    "description": "Generate a commit message for the staged changes with AI. Setup, config, hook and update subcommands are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": false,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "readme",
        "kind": "manual",
        "url": "https://github.com/Nutlope/aicommits#readme",
        "revision": "main 2026-10",
        "evidence": "- `--all` or `-a`: Automatically stage changes in tracked files for the commit (default: **false**)\n- `--clipboard` or `-c`: Copy the selected message to the clipboard instead of committing (default: **false**)\n- `--generate` or `-g`: Number of messages to generate (default: **1**)\n- `--exclude` or `-x`: Files to exclude from AI analysis\n- `--type` or `-t`: Git commit message format (default: **plain**). Supports `plain`, `conventional`, and `gitmoji`\n- `--prompt` or `-p`: Custom prompt to guide the LLM behavior (e.g., specific language, style instructions)\n- `--no-verify` or `-n`: Bypass pre-commit hooks while committing (default: **false**)\n- `--yes` or `-y`: Skip confirmation when committing after message generation (default: **false**)\n"
      }
    ],
    "field": [
      {
        "id": "all",
        "label": "Stage tracked changes",
        "type": "boolean",
        "option": [
          "--all",
          "-a"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "type",
        "label": "Message format",
        "type": "enum",
        "option": [
          "--type",
          "-t"
        ],
        "choices": [
          {
            "value": "plain",
            "label": "Plain"
          },
          {
            "value": "conventional",
            "label": "Conventional Commits"
          },
          {
            "value": "gitmoji",
            "label": "Gitmoji"
          }
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "generate",
        "label": "Messages to generate",
        "type": "integer",
        "option": [
          "--generate",
          "-g"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "prompt",
        "label": "Custom prompt",
        "type": "string",
        "option": [
          "--prompt",
          "-p"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "exclude",
        "label": "Exclude files",
        "type": "string",
        "option": [
          "--exclude",
          "-x"
        ],
        "multiple": true,
        "sources": [
          "readme"
        ]
      },
      {
        "id": "clipboard",
        "label": "Copy to clipboard instead of committing",
        "type": "boolean",
        "option": [
          "--clipboard",
          "-c"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "yes",
        "label": "Skip confirmation",
        "type": "boolean",
        "option": [
          "--yes",
          "-y"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "no_verify",
        "label": "Bypass pre-commit hooks",
        "type": "boolean",
        "option": [
          "--no-verify",
          "-n"
        ],
        "effect": "overwrite",
        "sources": [
          "readme"
        ]
      }
    ],
    "task": [
      {
        "id": "commit",
        "label": "Commit with an AI message",
        "fields": [
          "all",
          "type",
          "prompt",
          "yes"
        ],
        "required": []
      },
      {
        "id": "copy",
        "label": "Copy a message only",
        "fields": [
          "type",
          "generate",
          "clipboard"
        ],
        "required": [
          "clipboard"
        ],
        "set": {
          "clipboard": [
            true
          ]
        }
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "all",
          "type",
          "generate",
          "prompt",
          "clipboard",
          "yes"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "exclude",
          "no_verify"
        ]
      }
    ]
  }
}
