{
  "id": "toot",
  "name": "toot",
  "homepage": "https://toot.bezdomni.net/",
  "description": "A CLI and TUI tool for interacting with Mastodon instances from the command line.",
  "executables": [
    "toot"
  ],
  "dotfiles": {
    "paths": [
      "~/.config/toot/config.json",
      "%APPDATA%/toot/config.json",
      "~/.config/toot/settings.toml",
      "%APPDATA%/toot/settings.toml"
    ],
    "secret": [],
    "secret_paths": [
      {
        "file": [
          "~/.config/toot/config.json",
          "%APPDATA%/toot/config.json"
        ],
        "format": "json",
        "match": {
          "key_path": [
            "apps.*.client_secret",
            "users.*.access_token"
          ]
        }
      }
    ]
  },
  "commands": {
    "format": 1,
    "label": "Mastodon from the terminal",
    "description": "Post a status or read a timeline with toot. Login, account switching, polls, scheduling, thumbnails and the TUI are left to the command line.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": true
    },
    "subcommand": [
      {
        "path": [
          "post"
        ],
        "label": "Post a status",
        "description": "Post text, optionally with media. Leave the text empty to compose interactively or with an editor.",
        "source": [
          {
            "id": "src",
            "kind": "manual",
            "url": "https://raw.githubusercontent.com/ihabunek/toot/master/toot/cli/post.py",
            "revision": "2026-10-27",
            "evidence": "@click.argument(\"text\", required=False)\n\"--media\", \"-m\",\n\"--description\", \"-d\", \"descriptions\",\n\"--visibility\", \"-v\",\ntype=click.Choice(VISIBILITY_CHOICES),\nVISIBILITY_CHOICES = [\"public\", \"unlisted\", \"private\", \"direct\"]\n\"--sensitive\", \"-s\",\n\"--spoiler-text\", \"-p\",\n\"--reply-to\", \"-r\",\n\"--language\", \"-l\",\n\"--editor\", \"-e\",\ntoot post \"hello media\" --media path/to/image.png --description \"Cool image\"\n"
          }
        ],
        "field": [
          {
            "id": "text",
            "label": "Text",
            "description": "The status text. Leave empty to compose interactively.",
            "type": "string",
            "position": 0,
            "sources": [
              "src"
            ]
          },
          {
            "id": "visibility",
            "label": "Visibility",
            "type": "enum",
            "option": [
              "--visibility",
              "-v"
            ],
            "choices": [
              {
                "value": "public",
                "label": "Public"
              },
              {
                "value": "unlisted",
                "label": "Unlisted"
              },
              {
                "value": "private",
                "label": "Followers only"
              },
              {
                "value": "direct",
                "label": "Direct"
              }
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "media",
            "label": "Media files",
            "description": "Up to 4 attachments; give one description per file.",
            "type": "path",
            "option": [
              "--media",
              "-m"
            ],
            "multiple": true,
            "path": {
              "kind": "file",
              "role": "input"
            },
            "sources": [
              "src"
            ]
          },
          {
            "id": "description",
            "label": "Media descriptions",
            "description": "Accessibility description, one per attached media.",
            "type": "string",
            "option": [
              "--description",
              "-d"
            ],
            "multiple": true,
            "sources": [
              "src"
            ]
          },
          {
            "id": "sensitive",
            "label": "Mark sensitive",
            "type": "boolean",
            "option": [
              "--sensitive",
              "-s"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "spoiler_text",
            "label": "Content warning",
            "type": "string",
            "option": [
              "--spoiler-text",
              "-p"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "reply_to",
            "label": "Reply to status ID",
            "type": "string",
            "option": [
              "--reply-to",
              "-r"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "language",
            "label": "Language code",
            "description": "ISO 639-1 code, to skip automatic detection.",
            "type": "string",
            "option": [
              "--language",
              "-l"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "editor",
            "label": "Compose in editor",
            "description": "Editor command; leave empty to use the EDITOR variable.",
            "type": "string",
            "option": [
              "--editor",
              "-e"
            ],
            "sources": [
              "src"
            ]
          }
        ],
        "task": [
          {
            "id": "simple",
            "label": "Post text",
            "fields": [
              "text",
              "visibility",
              "spoiler_text",
              "language"
            ],
            "required": [
              "text"
            ]
          },
          {
            "id": "media_post",
            "label": "Post with media",
            "fields": [
              "text",
              "media",
              "description",
              "sensitive",
              "visibility"
            ],
            "required": [
              "text",
              "media"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "text",
              "visibility",
              "media",
              "description",
              "sensitive"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "spoiler_text",
              "reply_to",
              "language",
              "editor"
            ]
          }
        ]
      },
      {
        "path": [
          "timeline"
        ],
        "label": "Read a timeline",
        "description": "Show the home, public, hashtag, account or list timeline.",
        "source": [
          {
            "id": "src",
            "kind": "manual",
            "url": "https://raw.githubusercontent.com/ihabunek/toot/master/toot/cli/timelines.py",
            "revision": "2026-10-27",
            "evidence": "@click.option(\"--account\", \"-a\", help=\"Show account timeline\")\n@click.option(\"--list\", help=\"Show list timeline\")\n@click.option(\"--tag\", \"-t\", help=\"Show hashtag timeline\")\n@click.option(\"--public\", \"-p\", is_flag=True, help=\"Show public timeline\")\n\"--local\", \"-l\", is_flag=True,\nhelp=\"Show only statuses from the local instance (public and tag timelines only)\"\n\"--reverse\", \"-r\", is_flag=True,\n\"--once\", \"-1\", is_flag=True,\n\"--count\", \"-c\", type=int, default=10,\nhelp=\"Number of posts per page (max 20)\"\n"
          }
        ],
        "field": [
          {
            "id": "public",
            "label": "Public timeline",
            "type": "boolean",
            "option": [
              "--public",
              "-p"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "local",
            "label": "Local instance only",
            "description": "Only valid with the public timeline or a tag.",
            "type": "boolean",
            "option": [
              "--local",
              "-l"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "tag",
            "label": "Hashtag",
            "type": "string",
            "option": [
              "--tag",
              "-t"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "account",
            "label": "Account",
            "type": "string",
            "option": [
              "--account",
              "-a"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "list",
            "label": "List",
            "type": "string",
            "option": [
              "--list"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "count",
            "label": "Posts per page",
            "description": "Maximum 20.",
            "type": "integer",
            "option": [
              "--count",
              "-c"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "reverse",
            "label": "Newest at bottom",
            "type": "boolean",
            "option": [
              "--reverse",
              "-r"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "once",
            "label": "Do not prompt for more",
            "type": "boolean",
            "option": [
              "--once"
            ],
            "sources": [
              "src"
            ]
          }
        ],
        "task": [
          {
            "id": "home",
            "label": "Home timeline",
            "fields": [
              "count",
              "once",
              "reverse"
            ]
          },
          {
            "id": "public",
            "label": "Public timeline",
            "fields": [
              "public",
              "local",
              "count",
              "once"
            ],
            "set": {
              "public": [
                true
              ]
            }
          },
          {
            "id": "tagged",
            "label": "Hashtag timeline",
            "fields": [
              "tag",
              "local",
              "count",
              "once"
            ],
            "required": [
              "tag"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "public",
              "local",
              "tag",
              "account",
              "list"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "count",
              "reverse",
              "once"
            ]
          }
        ]
      }
    ]
  }
}