{
  "id": "keyring",
  "name": "keyring",
  "homepage": "https://github.com/jaraco/keyring",
  "description": "Store and access your passwords safely.",
  "executables": [
    "keyring"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/python_keyring/keyringrc.cfg",
      "%LOCALAPPDATA%/Python Keyring/keyringrc.cfg"
    ],
    "exclude": [],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Get, set or delete a password",
    "description": "Read, store or delete a password in the system keyring for a service and username. Backend paths, --disable and completion are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "help",
        "kind": "help",
        "url": "https://github.com/jaraco/keyring/blob/main/keyring/cli.py",
        "revision": "main 2026-10",
        "evidence": "\"-b\",\n\"--keyring-backend\",\nhelp=\"Name of the keyring backend\",\n\"--list-backends\",\nhelp=\"List keyring backends and exit\",\n\"--mode\",\nchoices=self.parser._get_modes,   # _get_modes = [\"password\", \"creds\"]\n\"--output\",\nchoices=self.parser._output_formats,   # _output_formats = [\"plain\", \"json\"]\nself.parser._operations = [\"get\", \"set\", \"del\", \"diagnose\"]\n'operation', 'service', 'username'\n"
      }
    ],
    "field": [
      {
        "id": "operation",
        "label": "Operation",
        "type": "enum",
        "position": 0,
        "choices": [
          {
            "value": "get",
            "label": "Get password"
          },
          {
            "value": "set",
            "label": "Set password (prompts)"
          },
          {
            "value": "del",
            "label": "Delete password"
          },
          {
            "value": "diagnose",
            "label": "Diagnose"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "service",
        "label": "Service",
        "type": "string",
        "position": 1,
        "sources": [
          "help"
        ]
      },
      {
        "id": "username",
        "label": "Username",
        "type": "string",
        "position": 2,
        "sources": [
          "help"
        ]
      },
      {
        "id": "backend",
        "label": "Keyring backend",
        "type": "string",
        "option": [
          "--keyring-backend",
          "-b"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "mode",
        "label": "Get mode",
        "type": "enum",
        "option": [
          "--mode"
        ],
        "choices": [
          {
            "value": "password",
            "label": "Password only"
          },
          {
            "value": "creds",
            "label": "Username and password"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "output",
        "label": "Output format",
        "type": "enum",
        "option": [
          "--output"
        ],
        "choices": [
          {
            "value": "plain",
            "label": "Plain"
          },
          {
            "value": "json",
            "label": "JSON"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "list_backends",
        "label": "List backends",
        "type": "boolean",
        "option": [
          "--list-backends"
        ],
        "sources": [
          "help"
        ]
      }
    ],
    "task": [
      {
        "id": "get",
        "label": "Get a password",
        "fields": [
          "operation",
          "service",
          "username"
        ],
        "required": [
          "operation",
          "service",
          "username"
        ],
        "set": {
          "operation": [
            "get"
          ]
        }
      },
      {
        "id": "set",
        "label": "Store a password",
        "fields": [
          "operation",
          "service",
          "username"
        ],
        "required": [
          "operation",
          "service",
          "username"
        ],
        "set": {
          "operation": [
            "set"
          ]
        }
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "operation",
          "service",
          "username"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "backend",
          "mode",
          "output",
          "list_backends"
        ]
      }
    ]
  }
}
