{
  "id": "radicle",
  "name": "Radicle",
  "homepage": "https://radicle.xyz",
  "description": "Peer-to-peer code collaboration stack.",
  "executables": [
    "rad"
  ],
  "dotfiles": {
    "paths": [
      "~/.radicle/config.json"
    ],
    "secret": [
      "~/.radicle/keys/"
    ],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Use Radicle repositories",
    "description": "Clone a repository by ID, list replicated repositories, or start the local node. Auth, issues, patches and identity commands are not covered.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": false,
      "short_attached": false,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "clone"
        ],
        "label": "Clone a repository",
        "description": "Clone a Radicle repository by its rad: ID.",
        "source": [
          {
            "id": "man",
            "kind": "manual",
            "url": "https://github.com/radicle-dev/heartwood/blob/master/rad.1.adoc",
            "revision": "master 2026-10-27",
            "evidence": "    $ rad clone rad:z3gqcJUoA1n9HaHKufZs5FCSGazv5\nbehavior can be changed by passing *--scope followed* when cloning.\n"
          }
        ],
        "field": [
          {
            "id": "rid",
            "label": "Repository ID",
            "description": "A rad:z… identifier.",
            "type": "string",
            "position": 0,
            "min": 1,
            "sources": [
              "man"
            ]
          },
          {
            "id": "scope",
            "label": "Seeding scope",
            "description": "followed limits updates to peers you follow; the default subscribes to all peers.",
            "type": "string",
            "option": [
              "--scope"
            ],
            "suggestions": [
              {
                "value": "followed",
                "label": "followed"
              }
            ],
            "sources": [
              "man"
            ]
          }
        ],
        "task": [
          {
            "id": "clone",
            "label": "Clone a repository",
            "fields": [
              "rid",
              "scope"
            ],
            "required": [
              "rid"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "rid",
              "scope"
            ]
          }
        ]
      },
      {
        "path": [
          "ls"
        ],
        "label": "List repositories",
        "description": "List repositories replicated on this node.",
        "source": [
          {
            "id": "man",
            "kind": "manual",
            "url": "https://github.com/radicle-dev/heartwood/blob/master/rad.1.adoc",
            "revision": "master 2026-10-27",
            "evidence": "You can see all replicated and locally-available repositories using:\n    $ rad ls --all\n"
          }
        ],
        "field": [
          {
            "id": "all",
            "label": "Include all locally available repositories",
            "type": "boolean",
            "option": [
              "--all"
            ],
            "sources": [
              "man"
            ]
          }
        ],
        "task": [
          {
            "id": "ls",
            "label": "List everything",
            "fields": [
              "all"
            ],
            "required": [],
            "set": {
              "all": [
                true
              ]
            }
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "all"
            ]
          }
        ]
      },
      {
        "path": [
          "node",
          "start"
        ],
        "label": "Start the node",
        "description": "Start the local Radicle node; it runs in the foreground unless daemonized.",
        "source": [
          {
            "id": "man",
            "kind": "manual",
            "url": "https://github.com/radicle-dev/heartwood/blob/master/rad.1.adoc",
            "revision": "master 2026-10-27",
            "evidence": "    $ rad node start\nThis will start the node in the foreground. Simply add *--daemon* to run the node in the background.\n"
          }
        ],
        "field": [
          {
            "id": "daemon",
            "label": "Run in the background",
            "type": "boolean",
            "option": [
              "--daemon"
            ],
            "sources": [
              "man"
            ]
          }
        ],
        "task": [
          {
            "id": "start",
            "label": "Start in the background",
            "fields": [
              "daemon"
            ],
            "required": [],
            "set": {
              "daemon": [
                true
              ]
            }
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "daemon"
            ]
          }
        ]
      }
    ]
  }
}