ego-mejia/radicle

Self-hosted · MCP built in · Inbox for your users · AGPLv3
> 🌱 Radicle is named after the radicle: the first root a seed puts out when it sprouts.
> Radi: Hi! I'm Radi, the green fellow in the corner of the app (and in the logo). I'll walk you through this README: look for my notes at the start of each section.
## Contents
Why Radicle
Quick start
Meet Radi
User guide
1. Create your first project
2. Add people
3. Work with tickets
4. Boards
5. Search with RQL
6. Sprints and backlog
7. Timeline and milestones
8. Reports and dashboards
9. Inbox and public form
10. Permissions, groups and restricted tickets
11. Single sign-on (SSO)
12. Audit log
13. AI agents over MCP
14. Keyboard, command palette and themes
15. Folio: your team's docs
Configuration
Architecture
Development
Roadmap and known issues
Contributing
License
## ✨ Why Radicle
| 🤖 Agents are teammates | A Model Context Protocol (MCP) server ships inside the app. Claude, Cursor or any MCP client can take a ticket, move it, tick its checklist, log time and comment, and it all shows up in the history as done by that agent. |
| 📮 Hear your users | Every project can open a public form. Complaints and ideas land in an Inbox, you score them on an impact × effort matrix and turn the good ones into tasks or bugs. The sender follows it with a tracking code. |
| 🔒 Serious access control | Groups, a permission matrix per project, restricted tickets that are invisible everywhere (search, boards, reports, MCP), OpenID Connect SSO and an append-only audit log. |
| 🗺️ Plan and see | Kanban and Scrum boards, sprints, a timeline with forecasts, ten agile and general reports and drag-and-drop dashboards. |
| 🟢 A guide inside | Radi, the mascot, answers how-to questions from the usage guide and, with an LLM of your choice, walks you through the screen step by step. |
| 📚 Docs next to the tickets | Folio, the second app, keeps the team's documentation: spaces, a block editor, versions, per-page permissions, search and a chat that answer with citations, real-time editing, templates, visual blocks, whiteboards and databases, links to Docket tickets, public pages, import from Confluence and Notion, export to PDF, Slack and Teams, webhooks, calendars, analytics, and an MCP so agents read and propose docs that an admin approves. |
| ⚡ Fast to work in | A query language (RQL), a command palette, keyboard shortcuts for everything and light and dark themes. In English and Spanish. |
| 🏠 Yours | One docker compose up. PostgreSQL, your server, your data. |
## 🚀 Quick start
> Radi: Three commands and you are in. The first visit asks you to create the instance admin.
You need Docker with Compose.
bash
git clone https://github.com/ego-mejia/radicle.git
cd radicle
cp .env.example .env
# Required: a long random secret. It encrypts stored secrets and signs links.
echo "RADICLESECRETKEY=$(openssl rand -hex 32)" >> .env
docker compose up -d
Open . The first visit shows a setup screen where you create the instance admin.
Three containers start: app (web app, REST API and MCP), worker (background jobs) and db (PostgreSQL 16). The REST API lives at /api/v1 and its interactive docs at /api/docs.
> [!TIP]