What is samurai-dojo?
samurai-dojo is a Claude Code mod by theonly1me that a Claude samurai cuts down a Codex, Gemini, or ChatGPT foe for every tool call, and meditates, trains, and duels between them through four seasons. It is listed under Agents & automation and has 4 GitHub stars.
| Type | Claude code mod |
|---|---|
| Author | theonly1me |
| Repository | theonly1me/claude-code-mods |
| Popularity | 4 GitHub stars |
| Category | Agents & automation |
| Security | Review before installing (76/100) |
| Rank | #767 of 5,272 Claude Code mods; #70 in Agents & automation |
| License | MIT |
| Last commit | 2026-10-05 |
| Stars this week | +2 |
| Hooks | 7 events |
| Sees | every tool call |
| Draws on | Pane |
Is samurai-dojo safe to install?
samurai-dojo scores 76/100 on the MCPMods security check: Review before installing. Things to review: writes files or config; reads environment variables. It passed 6 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| No network access | Pass |
| Starts no processes | Pass |
| Writes files or config | Review |
| Reads environment variables | Review |
| Only sees the events it hooks | Pass |
| Doesn't drive Claude | Pass |
| Passes claude plugin validate | Pass |
| Has an open-source license | Pass |
API calls in its code
| Call | What it means |
|---|---|
$.clock.every | |
$.clock.now | |
$.command.register | |
$.env.get | reads env vars |
$.fs.read | reads files |
$.fs.write | writes files |
$.state.get | |
$.state.set | |
$.store.get | keeps its own state |
$.store.set | keeps its own state |
$.ui.blit | draws interface |
$.ui.close | draws interface |
$.ui.invalidate | draws interface |
$.ui.open | draws interface |
$.ui.panes | draws interface |
$.ui.resolve | draws interface |
$.ui.toast | draws interface |
How do I install samurai-dojo?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/theonly1me/claude-code-mods claude plugin validate ./claude-code-mods/plugins/samurai-dojo
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add theonly1me/claude-code-mods && claude plugin install samurai-dojo@claude-code-mods
Or ask Claude to set it up
Paste this into Claude Code and it installs samurai-dojo for you:
Install the "samurai-dojo" Claude Code mod from https://github.com/theonly1me/claude-code-mods/tree/main/plugins/samurai-dojo. Run claude plugin validate on it first and show me what it can access before you enable it.
More from theonly1me/claude-code-mods
This repository has at least 9 Claude Code mods on MCPMods.
- change-journal: A live HTML page that shows every change Claude makes, with diffs, the reason for each edit, checks, and before/after be (Review before installing)
- decision-lens: See the decisions Claude made in each turn, why it made them, and steer future turns with keep and avoid rules. (Low risk)
- grill: While Claude works on your task, a sharp partner asks the questions that change the result. Answers reach Claude mid-tur (Review before installing)
- little-harvest: Every file that changes becomes a crop: Claude's edits and yours grow a farm in its own pane, tests bring sun or storms, (Review before installing)
- looks: Make Claude Code look the way you like: four themes (Retro CRT, Punk, Synthwave, Zen paper) switched with /theme, tidier (Low risk)
- night-feast: A vampire feeds on every tool call Claude finishes while the moon tracks how full the context window is. Between meals i (Review before installing)
- pocket-familiar: A fox spirit that lives on your work: passing tests feed it, finished turns cheer it, it plays while you are quiet, and (Review before installing)
- scope-guard: Notices when Claude drifts outside your request. Clear drift waits for your answer in a question dialog; milder drift is (Low risk)