# Radicle Command Reference Complete reference for all `rad` CLI commands and options. ## Identity Commands ### rad auth Create or authenticate cryptographic identity. ```bash rad auth # Interactive identity creation rad auth --alias "myname" # Set display alias rad auth --stdin # Read passphrase from stdin # Non-interactive examples: echo "" | rad auth --alias "name" --stdin # No passphrase echo "pass" | rad auth --alias "name" --stdin # With passphrase RAD_PASSPHRASE="pass" rad auth --alias "name" # Via environment ``` ### rad self Display current identity information. ```bash rad self # Show DID, NID, alias rad self --did # Show only DID rad node status --only nid # Show only Node ID rad self --home # Show Radicle home directory ``` ## Repository Commands ### rad init Initialize a Git repository for Radicle. ```bash rad init # Interactive mode rad init --name "name" # Set repository name rad init --description "desc" # Set description rad init --default-branch main # Set default branch rad init --public # Public visibility rad init --private # Private visibility rad init --no-confirm # Skip confirmation prompt ``` ### rad clone Clone a repository from the network. ```bash rad clone rad: # Clone by RID rad clone rad: ./dir # Specify directory rad clone rad: --no-seed # Clone without seeding rad clone rad: --scope followed # Limit to followed delegates rad clone rad: --scope all # Include all contributors ``` ### rad ls List repositories. ```bash rad ls # List local repositories rad ls --seeded # List seeded repositories rad ls --all # List all known repositories ``` ### rad . Show current repository's RID. ```bash rad . # Print RID of current repository ``` ### rad seed / rad unseed Manage repository seeding. ```bash rad seed rad: # Start seeding a repository rad seed rad: --scope followed # Seed with scope rad unseed rad: # Stop seeding ``` ### rad publish Convert private repository to public. ```bash rad publish # Make current repository public ``` ## Patch Commands ### rad patch Work with patches (pull request equivalent). ```bash # List patches rad patch list # List open patches rad patch list --all # List all patches rad patch list --merged # List merged patches rad patch list --draft # List draft patches rad patch list --archived # List archived patches rad patch list --author # Filter by author # Show patch rad patch show # Show patch details rad patch show --patch # Include diff rad patch show --revision 2 # Show specific revision # Diff rad patch diff # Show patch diff rad patch diff --revision 2 # Diff specific revision # Checkout rad patch checkout # Checkout patch branch rad patch checkout --revision 2 # Checkout specific revision # Comment (takes a revision ID, not a patch ID) rad patch comment # Add comment (opens editor) rad patch comment -m "text" # Inline comment # Review rad patch review --accept # Accept patch rad patch review --reject # Reject patch rad patch review --accept -m "text" # Accept with message # Archive/Unarchive rad patch archive # Archive patch rad patch unarchive # Unarchive patch ``` ### Creating Patches via Git ```bash # Open new patch (magic ref) git push rad HEAD:refs/patches # Set or edit patch title/description after opening rad patch edit -m "Title Body" # Other push options git push rad -o patch.draft HEAD:refs/patches # open as draft git push rad -o patch.base= HEAD:refs/patches # set base commit git push rad -o no-sync HEAD:refs/patches # don't announce after push # Supported push options: patch.message= (repeatable, no newlines), # patch.draft, patch.base=, patch.branch[=], sync, no-sync, hints. # Update existing patch from a patch branch git push rad # Update existing patch after rebase/amend git push --force rad # Push and set upstream git push -u rad HEAD:refs/patches ``` ## Issue Commands ### rad issue Manage issues. ```bash # Create rad issue open # Open editor for new issue rad issue open --title "Title" # Set title rad issue open --title "T" --description "D" # Set title and description rad issue open --title "T" --description "D" --labels "bug ux" # Set labels rad issue open --title "T" --assignees # Set assignees # List rad issue list # List open issues rad issue list --all # List all issues rad issue list --closed # List closed issues rad issue list --solved # List solved issues rad issue list --assigned # List assigned issues rad issue list --author # Filter by author # Show rad issue show # Show issue details # Comment rad issue comment # Add comment (editor) rad issue comment --message "text" # Inline comment # State rad issue state --closed # Close issue rad issue state --open # Reopen issue rad issue state --solved # Mark issue solved # Assignment rad issue assign --add # Assign to peer rad issue assign --delete # Unassign # Labels rad issue label --add bug # Add label rad issue label --delete bug # Remove label ``` ## Node Commands ### rad node Manage the Radicle node. ```bash rad node start # Start node daemon rad node stop # Stop node rad node status # Check node status and connections rad node connect @
# Connect to specific peer rad node routing # Show routing table ``` ### rad sync Synchronize with the network. ```bash rad sync # Sync current repository rad sync --fetch # Force fetch updates rad sync --announce # Announce local refs rad sync status # Check sync status rad sync --scope all # Sync all seeded repos rad sync --scope followed # Sync only followed delegates ``` ### rad inbox View notifications. ```bash rad inbox # Show all notifications rad inbox --clear # Clear notifications ``` ## Remote Commands ### rad remote Manage peer remotes. ```bash rad remote add # Add peer remote rad remote add --name alice # Add with alias rad remote remove # Remove remote rad remote list # List remotes rad remote list --untracked # Show untracked peers ``` ## Identity Management ### rad id Manage repository identity/delegates. ```bash # Update repository access (private repos) rad id update --title "Grant access" --allow rad id update --title "Revoke access" --disallow rad id update --title "Change name" --name "new-name" rad id update --title "Update desc" --description "new description" # List delegates rad id list ``` ## Configuration ### rad config Manage Radicle configuration. ```bash rad config # Show current config rad config edit # Edit config file rad config set # Set config value rad config get # Get config value ``` ## Utility Commands ### rad inspect Inspect Radicle objects. ```bash rad inspect # Inspect repository rad inspect --refs # Show refs rad inspect --history # Show history ``` ### rad web Open web interface. ```bash rad web # Open repository in browser (if web UI configured) ``` ## Public Seed Nodes Connect to public infrastructure for better distribution: - `iris.radicle.xyz` - Public seed node - `rosa.radicle.xyz` - Public seed node - `willow.radicle.xyz` - Public seed node Configure in `rad config edit` under `[node]` section. ## Environment Variables - `RAD_HOME` - Override default Radicle home directory - `RAD_PASSPHRASE` - Provide passphrase non-interactively (use with caution) - `RAD_DEBUG` - Enable debug logging ## Exit Codes - `0` - Success - `1` - General error - `2` - Command line parsing error - `3` - Network error - `4` - Authentication error