Skip to content

quickstart / first lesson

Enter the dojo.

Claim your invitation with GitHub first. Then choose your coding agent, review the installer, and sign in with the same GitHub account in WaitDojo. The browser lesson is available without an invitation.

Before the first bow.

1. Install the reviewed release.

Install WaitDojo for Codexbash
curl -fsSL 'https://waitdojo.dev/install.sh' | sh -s -- --agent codex

That example selects Codex. Choose Claude Code in the product configurator to generate the matching command. The installer never needs sudo and its exact source is readable before it runs.

2. Verify the training room.

Terminalbash
waitdojo doctor --product

The Doctor checks the platform, tmux, agent command, passive hooks, terminal geometry, install path, and local data directory. Every problem includes a stable remediation link.

3. Start the useful-wait loop.

Terminalbash
waitdojo
Ordered instructions
  1. Sign in with the GitHub account that claimed your beta invitation and choose a WaitDojo username when prompted.
  2. Review and approve the passive lifecycle hooks during first run.
  3. Start a task in the configured coding agent.
  4. Press Enter to begin the recommended rep or Tab for another.
  5. Finish the rep, review the result, then return to the agent with Esc.

If the agent needs approval mid-rep, WaitDojo pauses and collapses. The unfinished rep is offered again when the agent resumes.

The five controls worth learning.

start, answer, or continueprimary action
show another recommendationrecommendation only
collapse and return to the agentattention return
browse every activityactivity catalog
toggle the WaitDojo panetmux session

Browser lesson versus installed product.

The browser lesson is a temporary simulation with a fictional codebase question. It never connects to your terminal or repository and resets on reload. The installed app runs in your terminal, records results locally, and uses only supported lifecycle event names and timestamps to know when the agent needs you.