klerb-cli

Companion CLI for Klerb classroom lessons. Pairs your agent (Claude Code, Cursor, anything that loads skills + slash commands) with the lesson you're watching in the browser, so the agent can read the transcript, probe your local environment, and walk you through every step of the lesson tailored to what you've already done.

Install

npm i -g klerb-cli

The binary is named klerb. Requires Node 18+.

Without npm

curl -sSL https://klerb.io/install.sh | sh

Drops a klerb binary in ~/.klerb/bin.

Quick start (Claude Code)

klerb login

A browser tab opens, auto-authorizes after a 3-second countdown (no clicks in the happy path), saves a token to ~/.klerbrc, and automatically installs:

• ~/.claude/skills/klerb.md — companion playbook
• ~/.claude/commands/klerb.md — /klerb slash command

Then open a lesson in your browser and, in Claude Code, type:

/klerb

The agent will pair with whatever lesson you have open, read the full transcript, check your local environment for every action the lesson asks for, and show you a filtered to-do list of just the steps you actually need to do.

What /klerb gives you

Every lesson, you see a menu like:

You're on "1.1 Installing Claude Code" in Agent Architects.

What would you like to do?
  1. Watch with me — I follow along with the transcript
  2. Read the lesson — skip the video, walk the notes
  3. Take the quiz (3 questions)
  4. Mark complete
  5. Something else

Pick Watch with me and the agent builds an inventory:

# | @time  | Action                                    | Status
1 | 01:21  | Install VS Code                           | ✅ done
2 | 01:57  | Create a project folder                   | ⏭ skippable
3 | 03:19  | Run `npm i -g @anthropic-ai/claude-code`  | ✅ done (v2.1.119)
4 | 06:04  | Install the Claude Code VS Code extension | ✅ done

Net: you have 0 things to do.

Then offers to keep watching, jump to a row, do a step live, or skip to the quiz.

If the lesson author placed moments in the video (timed checkpoints for exercises, decision branches, or inline quizzes), the browser pauses the video at those points and the agent steps in to run them — then auto-resumes when you say done.

Using with other agents

Cursor, Windsurf, Aider, plain Claude — anything that loads SKILL.md files. The skill is bundled at:

node_modules/klerb-cli/skill/SKILL.md

Copy it to your agent's skills directory if klerb login didn't already install it (it only writes to ~/.claude/ by default).

For agents that don't speak skills, just paste this prompt:

Use the klerb-cli to pair with my current klerb.io lesson. Run klerb to see the pairing, render the menu of options (Watch / Read / Quiz / Complete), and follow the playbook for whichever I pick. For Watch mode, build an action inventory first by reading the full transcript via klerb session transcript, probing my environment for each concrete step, and showing me a filtered to-do list.

Commands (rarely typed by hand)

| Command | What it does | |---|---| | klerb | Pair with the lesson you have open in your browser | | klerb login | Device-code login, installs skill + slash command | | klerb logout | Forget the saved token | | klerb me | Profile + communities | | klerb current | Print the next uncompleted lesson | | klerb play [id] | Start a session (defaults to current lesson) | | klerb complete <id> [--proof <url>] [--note "..."] | Mark complete | | klerb quiz / klerb quiz start / klerb quiz answer <v> / klerb quiz finish | Quiz flow | | klerb session state / seek / back / goto / play / pause | Video sync | | klerb session transcript | Full lesson transcript (used for inventory) | | klerb session moments / resolve / skip / redo | Moment control | | klerb session append / respond / log | Action log | | klerb session end [--complete] | End session (optionally complete) |

Environment

| Variable | Effect | |---|---| | KLERB_TOKEN | Overrides ~/.klerbrc. For one-shot runs / CI. | | KLERB_HOST | API host. Defaults to https://klerb.io. |

Auth

Tokens are minted via device-code flow on klerb login. Default scopes: lesson:read, lesson:complete, session:write, quiz:attempt.

Revoke any token from https://klerb.io/account (Personal Access Tokens section).

Config file

~/.klerbrc (mode 0600) is a small JSON file:

{
  "host": "https://klerb.io",
  "token": "klerb_..."
}

License

MIT © Bon Ayr Industries