Documentation

Welcome to Radish

A browser-based interface for collaborating on Radicle repositories — open issues, comment on patches, and propose changes without installing anything.

What is Radish?

Radicle logo Radicle is a peer-to-peer code collaboration network. Existing tooling typically requires you to install the rad CLI and run a local node before you can do anything useful — even leaving a comment.

Radish logo Radish removes that barrier for casual contributors. Sign in with GitHub and you can immediately read repositories, file issues, comment on patches, and edit files. Your Radicle identity is created for you, and travels with you across instances.

Five-minute tour

Sign in with GitHub. Click Sign in in the top-right. Radish only reads your GitHub username unless you opt into GitHub-stored keys.
Pick where to keep your signing key. During onboarding you choose between storing your key on GitHub (portable across instances) or on this server (no extra GitHub permissions).
Browse a repository. Open any repo from the home page. You can read the README, switch branches, browse files, and view commits and diffs.
Contribute. File an issue, leave a comment on a patch, or click Edit on any file to propose a change. Radish signs the operation with your key and writes it to local Radicle storage.

What's in these docs

Accounts & sign-in

How GitHub OAuth works, what data Radish reads, and how sessions are stored.

Keys & identity

Where your Radicle signing key lives, how to switch storage, and how to export it.

Repositories

Creating new repos, browsing source, switching peers and branches, reading commits.

Issues

Filing bugs, leaving comments, and applying labels.

Patches

Proposing changes from the browser by editing files in place.

Repository settings

Delegates, identity proposals, and the threshold quorum.

Running a local node

Graduating from Radish by importing your key into a full Radicle install.

How Radish fits into Radicle

Radish is not a separate network. Each instance runs alongside a real radicle-node and reads and writes the same on-disk Radicle storage that the CLI uses. Anything you do here is signed by a real Radicle key and replicated to peers like any other Radicle activity.

The only thing Radish adds on top is a friendlier door: a hosted node, a browser UI, and a way to keep your signing key under your own control without installing anything.