ksp learn
DocsCLIksp learn

ksp learn

Command Reference

Start an interactive, guided terminal tutorial walking through KSP architecture, handshakes, and framing.

Interactive & Fun

Purpose

Start an interactive, guided terminal tutorial walking through KSP architecture, handshakes, and framing.

Syntax

Command-line specification
bash / powershell
ksp learn [LESSON_NUMBER | TOPIC]

Arguments

ArgumentDescription
[LESSON_NUMBER | TOPIC]Optional tutorial module: `1` (Introduction), `2` (Handshake), `3` (Encryption), `4` (Streams).

Example Usage

Example command
ksp learn 2

Expected Output

════════════════════════════════════════════════════════════
══           KSP Interactive Academy — Lesson 2           ══
════════════════════════════════════════════════════════════
  Module: The 1.5-RTT Ephemeral Handshake

  Step 1: ClientHello
    The client generates a random 32-byte X25519 private key and sends only the
    public key along with `ClientHello`.

  Interactive Prompt: Press [Enter] to generate your simulated ephemeral key...
  > Ephemeral Public Key generated: 0x9F4B21...

  Step 2: ServerHello + Key Derivation
    The server replies with its own X25519 key. Both sides instantly compute the
    Shared Secret using Diffie-Hellman!

  ✔ Lesson 2 completed! Run `ksp learn 3` to explore AEAD encryption.
Implementation Notes

Designed specifically to onboard new engineers into the KSP ecosystem in under 5 minutes right from their terminal.