Get started

install

Set up a project and its coding agents for dojofoo.

npx dojofoo install [--claude] [--opencode] [--codex] [--gemini] [--pi]

Run it once in the folder you open in your agent. setup is an alias.

Options

OptionDescription
--claudeSet up Claude Code
--opencodeSet up OpenCode
--codexSet up Codex
--geminiSet up Gemini CLI
--piSet up Pi
--agent <a,b>The same, as a list: --agent claude,codex
--skillsOnly refresh the dojofoo skill for the agents already set up

Without an option, install detects the agent it runs in. Outside an agent it asks, offering OpenCode, Codex and Pi.

Examples

npx dojofoo install                      # detect, or ask
npx dojofoo install --claude             # choose
npx dojofoo install --agent opencode,pi  # several at once

What it does

  • Adds mise for your user when it's missing (not with --skills).
  • Creates .dojo/config.yaml and the courses/ folder.
  • Writes the deprecated /kata and /dojo commands to .agents/commands/ and links them into each agent's folder, e.g. .claude/commands/.
  • Writes the dojofoo skill to .agents/skills/dojofoo/SKILL.md.
  • For Claude Code, writes .claude/settings.json so the agent may run npx dojofoo without asking.

It's safe to run again, e.g. to add another agent. Commands you've edited in .agents/commands/ are kept; the skill is refreshed.

With --claude, install replaces .claude/settings.json. Back it up first if you've customized it.

  • add – install a course
  • ui – start learning in your browser
Edit on GitHub