dojocho

Documentation

Installable coding dojos that turn your AI agent into a sensei. You do the typing, the agent runs tests and asks Socratic questions.

What's dojocho?

dojocho is a kata-driven training framework for AI coding agents. You install a dojo — a curated set of failing tests with teaching prompts — and your agent guides you through them like a Socratic sensei. No solutions handed out. Just questions, hints, and the next failing test.

You do the typing. The agent runs the tests, watches what you wrote, and asks the next question. Each dojo is a curated set of katas, and each language gets its own pluggable ryu (style/school) so the prompts stay idiomatic.

Quickstart

dojo setup
dojo add effect-ts
claude /kata

setup detects your coding agent (via env vars like CLAUDECODE=1) and wires the /kata slash command into it, add pulls in a dojo, and /kata puts you in front of your first failing test with the sensei watching. Pass --claude, --opencode, --codex, or --gemini if you need to override detection.

Where to go next

  • Getting Started — install the CLI, scaffold your first dojo project.
  • Commands — the dojo CLI surface: setup, add, kata.
  • Dojos — the installable catalog (effect-ts, pydantic-agents, more on the way).

On this page