/kata (deprecated)

The former way to start a lesson from inside your coding agent. Use npx dojofoo instead.

/kata is deprecated: not every course is made of katas. Learn with npx dojofoo instead. Projects set up before keep the command for now.

/kata is a command you type in your agent, not in the shell. npx dojofoo install adds it, along with /dojo.

/kata

What happens

  1. The agent starts the lesson UI in the background and reads where you are: no course yet, the course's introduction, a kata's briefing, or practice.
  2. It teaches from the course's notes for that step – asking questions and giving hints, not solutions.
  3. When you're ready, it runs the kata's tests. When they pass, the kata is complete and you choose: review it, move on to the next one, or pause.
  4. Before it stops, it notes what it learned about how you work, so the next session builds on it.

Progress lives in the project. Run /kata again any time to pick up where you left off.

/dojo

/dojo passes its arguments to the CLI, for anything else:

/dojo --list               list the installed courses
/dojo --change effect-ts   switch the active course

The CLI underneath

The agent drives these; you can run them yourself too.

CommandDoes
npx dojofoo statusShow where you are in the course
npx dojofoo kataPrint the current kata's teaching notes
npx dojofoo kata introShow the current kata's briefing
npx dojofoo kata --checkRun the current kata's tests
npx dojofoo kata --startSet up the next kata
npx dojofoo kata --listList the katas and their state
npx dojofoo kata --change <name>Switch to a kata and set it up
npx dojofoo kata --note "text"Record an observation about the learner
  • ui – learn in your browser instead
  • Teaching notes – what the sensei teaches from
Edit on GitHub