RAD-ID(1)                     Radicle CLI Manual                     RAD-ID(1)

<?><?><?> (NAME)
       rad-id - <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> Radicle.

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       rad id [<option>...]
       rad id list [<option>...]
       rad id update [--title <string>] [--description <string>] <option>...
       rad id edit <revision-id> [--title <string>] [--description <string>]
       [<option>...]
       rad id show <revision-id> [<option>...]
       rad id accept | reject <revision-id> [<option>...]
       rad id redact <revision-id> [<option>...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> rad id <?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?> Radicle <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> (identity
       document) <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
       (delegates) <?><?><?>. <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> (quorum)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> Canonical
       JSON <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (COMMANDS)
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> rad id
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> list <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (revisions) <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.

   list
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>.

   update
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       --title <string>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?>.

       --description <string>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?>.

       --delegate <did>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?> DID <?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --rescind <did>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> DID <?><?>
           <?><?><?><?> <?><?><?><?><?><?>.

       --threshold <num>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?>.

       --visibility <private> | <public>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?> (private) <?><?> <?><?><?><?><?>
           (public).

       --allow <did>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           (peer) <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?>.

       --disallow <did>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

       --payload <id> <key> <val>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?> (payloads) <?><?><?><?>.
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?> <?><?><?> null <?><?><?><?><?> <?><?><?><?>.

       --no-confirm
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?>.

       --edit
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> ($EDITOR)
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> JSON.

   edit
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <<<?><?><?><?>>> (active)
       <?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> update <?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?> update
       <?><?><?><?><?><?><?> <?><?><?><?>.

   show
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?>.

   accept
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?>>> (active) <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

   reject
       <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?>>> (active) <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

   redact
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> (redact) <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?><?><?><?><?><?><?>>> (accepted) <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       --repo <rid>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.

       --quiet, -q
           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>.

       --help
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> (Adding a delegate)
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> update
       <?><?><?><?><?><?><?> <?><?><?><?>:

           $ rad id update --title "Add Bob" --description "Add Bob as a delegate" \
               --delegate did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk \
               --threshold 2

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> DID <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?> <?><?> <?><?><?><?> <?><?> <?><?><?> 2 <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>.

   <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       (Changing repository visibility)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?>:

           $ rad id update --visibility private

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

   <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> (Changing a
       repository payload)
       <?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       xyz.radicle.project <?><?><?><?><?> <?><?><?><?><?><?>:

           $ rad id update --title "Update title and description" \
               --description "Improve clarity" \
               --payload xyz.radicle.project name '"radicle-beans"' \
               --payload xyz.radicle.project description '"Tasty Radicle beans"'

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> --payload<?> <?><?><?><?><?>
       "radicle-beans"<?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> JSON
       <?><?><?><?><?>. <?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> (double quotes) <?><?><?><?>
       <?><?><?><?><?>.

   <?><?><?> <?><?> <?><?><?><?><?><?><?> (Removing a delegate)
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> --rescind <?><?><?><?><?><?><?> <?><?><?><?>:

           $ rad id update --title "Remove Bob" \
               --description "Bob is no longer a delegate" \
               --rescind did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk \
               --threshold 1

       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?>.  <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>!

   <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> (Adding Canonical References Rules)
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> --payload xyz.radicle.crefs <?><?> <?><?><?><?>
       rules <?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?>:

           $ rad id update --title "Update canonical reference rules" \
               --payload xyz.radicle.crefs rules '{
                     "refs/heads/master": { "threshold": 1, "allow": "delegates" },
                     "refs/tags/*": { "threshold": 2, "allow": "delegates" },
                     "refs/tags/qa/*": { "threshold": 1, "allow": "delegates" }
                 }'

       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> --edit <?><?> <?><?><?><?><?> update
       <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?>:

           {
             "payload": {
               "xyz.radicle.crefs": {
                 "rules": {
                   "refs/heads/master": {
                     "allow": "delegates",
                     "threshold": 1
                   },
                   "refs/tags/*": {
                     "allow": "delegates",
                     "threshold": 1
                   },
                   "refs/tags/qa/*": {
                     "allow": "delegates",
                     "threshold": 1
                   }
                 }
               },
               "xyz.radicle.project": {
                 "defaultBranch": "master",
                 "description": "Radicle Heartwood Protocol & Stack",
                 "name": "heartwood"
               }
             },
             "delegates": [
               "did:key:z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi"
             ],
             "threshold": 1
           }

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?> Radicle

rad 1.0.0                         2026-08-28                         RAD-ID(1)