| title |
Command line (CLI) |
| sidebar_label |
Command line (CLI) |
What it's for: querying and managing your coaching data from the terminal — quick lookups, scripting,
backups, and tuning settings without leaving the shell. It's a power-user companion to the automatic
coaching in your agent; everything here is also available in the
web dashboard.
Built on Commander, so every command supports --help.
devcoach --help # list all commands
devcoach <command> --help # usage for one command
devcoach --version
Prefix any command with npx -y if you haven't installed globally (npm i -g devcoach).
Mutating commands write to ~/.devcoach/coaching.db; sandbox them with DEVCOACH_DIR=$(mktemp -d) devcoach ….
| Command |
Description |
devcoach mcp |
Start the MCP server (stdio) — used by your agent's MCP config |
devcoach install [--claude-code] [--claude-desktop] [--gemini] [--codex] [--force] [--skip-hook] |
Register the MCP server (user scope) + hooks + skill for the chosen agents; repairs stale hook layouts |
devcoach doctor |
Diagnose the Claude Code wiring and pacing state — explains why the next stop would or wouldn't cue a lesson |
devcoach setup |
Interactive terminal onboarding wizard in four steps: backup path (or skip) → automatic or manual topics → optional groups → daily limit and minimum gap |
devcoach ui [--port <n>] |
Launch the web dashboard (default port 7860; binds 127.0.0.1 only) |
devcoach stop-hook / prompt-hook |
Claude Code hooks (hidden from --help): Stop (onboarding check + lesson cue) and UserPromptSubmit (priming). Exit 0 always; silent or a JSON directive on stdout. Trace decisions with DEVCOACH_HOOK_DEBUG=1 |
devcoach gemini-stop-hook / gemini-prompt-hook |
The same pair for Gemini CLI (beta), registered by install --gemini |
devcoach codex-stop-hook / codex-prompt-hook |
The same pair for Codex (beta), registered by install --codex |
devcoach onboard-hook / lesson-ready |
Legacy two-entry Stop hooks (still supported; install migrates to stop-hook) |
| Command |
Description |
devcoach profile |
Show the knowledge map with confidence bars |
devcoach knowledge-add <topic> [--confidence <0-10>] [--group <name>] |
Add or update a topic |
devcoach knowledge-remove <topic> |
Remove a topic |
devcoach group-add <name> / group-remove <name> |
Create / delete a group |
devcoach group-assign <topic> <group> |
Move a topic to a group (Other to ungroup) |
| Command |
Description |
devcoach lessons [--period <p>] [--level <l>] [--category <c>] [--project/--repository/--branch/--commit <…>] [--starred] [--feedback <f>] [--date-from/--date-to <YYYY-MM-DD>] [--sort <col>] [--order <asc|desc>] |
List lessons with filters |
devcoach lesson <id> |
Show a single lesson in full |
devcoach star <id> / unstar <id> |
Star / unstar |
devcoach delete <id> |
Permanently delete a lesson |
devcoach feedback <id> <know|dont_know|clear> |
Record comprehension (adjusts confidence) |
| Command |
Description |
devcoach stats |
Lesson counts, rate-limit status, weakest/strongest topics |
devcoach settings |
Show current settings — max_per_day, min_gap_minutes, nudge_every, nudge_scope |
devcoach set max_per_day <n> |
Max lessons per 24h (1–20, default 2) |
devcoach set min_gap_minutes <n> |
Minimum minutes between lessons (0–1440, default 240) |
devcoach set nudge_every <n> |
Interactions between lesson cues (0–1000, default 10; 0 = every turn) |
devcoach set nudge_scope <session|global> |
Count interactions per chat session (default) or globally |
Your whole profile lives in one place, so moving it between machines is a single command each way.
# Export everything → a portable zip (settings + knowledge map + lessons + notebook)
devcoach backup ~/devcoach-$(date +%F).zip # default file: devcoach-backup.zip
# Import on another machine (or restore after a reset)
devcoach restore ~/devcoach-2026-06-19.zip
| Command |
Description |
devcoach backup [file.zip] |
Export settings + knowledge map + lessons + notebook (default devcoach-backup.zip) |
devcoach restore <file.zip> |
Import a backup — settings overwritten, knowledge upserted, duplicate lessons skipped |
On restore, your profile and full lesson history are merged in; you can also point the
onboarding wizard at a backup. The same export/import is available in the
web dashboard's Settings page. For the zip's internal format, see
Configuration & data.
| Variable |
Effect |
DEVCOACH_DIR |
Relocate the data directory (default ~/.devcoach) — sandboxing, tests, a second profile |
DEVCOACH_HOOK_DEBUG=1 |
Trace every hook decision to ~/.devcoach/hook.log |
NO_COLOR |
Disable coloured terminal output |
devcoach lessons --period week --level senior --starred
devcoach lessons --category docker --sort timestamp --order asc
devcoach feedback 9f3a know
devcoach set min_gap_minutes 120
devcoach backup ~/devcoach-$(date +%F).zip