๐ the agentic stack for those who have to save tokens
$ npx -y skills add shortcuts/radin --agent claude-code
What's inside
A Claude Code plugin for a solo dev on a small subscription. One curl | bash
gives you:
curl -fsSL https://raw.githubusercontent.com/shortcuts/radin/main/install.sh | bash
Needs curl, tar, bash, and the claude CLI. Two files are C -- the TUI and the
JSON surgery behind radin repair: install builds both with cc (Xcode
Command Line Tools on macOS, gcc on Linux) and skips each with a warning when
no compiler is there. Companion tools pull their
own stacks; one that fails is reported and skipped, and radin still installs.
rtk and headroom install through Homebrew, mise, or their own
installers -- the install asks which.
Install asks two questions: one about radin-execute's sub-agent models,
one naming the package manager for companion tools. Add -s -- --yes to take the defaults. Add -s -- --verbose to
trace every command, for an install that hangs or fails.
Update the whole stack โ radin plus every companion โ with radin update. The
answers come from ~/.claude/.radin/manifest.json, so nothing is re-asked.
| Command | What it does |
|---|---|
/radin-record | Turn a bug, idea, or aside raised mid-session into a backlog task |
/radin-plan | Write a step-by-step plan for one task, touching no code |
/radin-execute | Work the backlog: prioritize, implement, commit, one task per commit |
/radin-review | Two-axis pass over a scope โ repo rubrics, plus the originating entry's spec; kept findings become tasks |
/radin-show | Print the backlog |
/radin-stats | Every companion tool's own savings report, side by side |
/radin-doctor | Verify the install, report unreachable companions |
/radin-uninstall | Remove what install.sh put in ~/.claude |
radin | Full-screen backlog browser for humans: bare radin on a terminal is the human entry point. No agent involved; ? lists keys. Off a terminal it prints the usage text and exits non-zero, so a skill or pipe never hangs in a full-screen app. radin help prints that text on purpose |
Typical loop: record โ (plan) โ execute โ review, whose findings feed the next
execute. Each skill runs in your own conversation, so it can ask you
questions; only leaf work goes to sub-agents. /radin-execute confirms the
order before it starts, and every task's state is on disk, so interrupting it
costs nothing. Want your thread free? Dispatch it from claude agents or a
second claude session โ the worktree-per-task answer keeps concurrent runs
off each other's checkout.
One directory per repo: <repo-root>/.claude/.radin/ โ the backlog index, one
markdown file per task, plans, reviews, and execution state. Commit it to
share the backlog with your team, or gitignore it to keep it private. radin
never touches your .gitignore.
Every tool goes through the radin CLI (radin backlog, radin state), so
nothing hand-edits those files. A task carries a category
(feat/fix/chore/refactor), an optional priority and depends_on, and
can sit under an epic whose DESCRIPTION.md every child inherits.
| Tool | What it does |
|---|---|
| rtk | Wraps dev commands, cuts their output 60-90% |
| caveman | Terse agent prose, ~65% fewer tokens |
| ponytail | Makes the agent think like the laziest senior dev in the room |
| codebase-memory-mcp | Indexes the repo into a knowledge graph, so the agent asks instead of grepping |
| headroom | Whole-session context compression, complements rtk's per-command one |
| thermo-nuclear | Maintainability review skill |
| mattpocock-skills | Engineering skills; radin delegates interviewing and research here |
Two caveats: a graph answer is a pointer, never proof of absence โ read the
file before editing. And after codebase-memory-mcp update, run
radin repair, because that update reruns a config write which
drops other tools' hooks. radin snapshots ~/.claude/settings.json and
~/.claude.json into ~/.claude/.radin/backups/ before that write and never
deletes a snapshot; codebase-memory-mcp uninstall undoes upstream's own side.
Full list in
docs/technical-constraints.md.
Hacking on radin itself? AGENTS.md, CONTRIBUTING.md.
FAQ
radin is a Claude Code plugin with 9 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes radin-doctor, radin-execute, radin-plan. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it