Quickstart

This guide assumes you've installed the CLI and have Claude Code (or another supported agent) set up.

1. Wire up your project

Run dojo setup once per project. It registers the /kata slash command, writes the agent rules that tell your sensei how to behave, and sets up the expected directory layout.

dojo setup

2. Add a dojo

Install the dojo you want to train on. Each dojo is a normal npm package — the CLI just knows where to wire it.

dojo add effect-ts

Replace effect-ts with any dojo from the catalog, e.g. pydantic-agents.

3. Start training

In Claude Code (or your agent of choice), run:

/kata

Your sensei opens the next kata, reads its SENSEI.md, and starts asking questions instead of writing code for you. When the kata's test goes green, /kata advances to the next one.

What's next

• Skim the commands reference to learn dojo end-to-end.
• Browse the dojo catalog to pick your next discipline.