@keeroklab/cli

CLI wrapper for Keerok Lab — live Claude Code supervision for training sessions.

Students connect to a supervised session where the instructor can monitor terminals in real-time, send messages, and manage API budgets.

Quick Start

Your instructor will provide the <token> via email or the session page.

macOS / Linux (no install needed)

curl -fsSL https://keerok.tech/lab/install.sh | bash -s -- <TOKEN>

This will automatically download Node.js if it's not installed on your machine.

Windows (PowerShell)

irm https://keerok.tech/lab/install.ps1 -OutFile keerok.ps1; .\keerok.ps1 <TOKEN>

If you already have Node.js

npx @keeroklab/cli connect <token> --server https://keerok.tech

Requirements

• A terminal (macOS Terminal, iTerm2, Windows Terminal, etc.)
• Node.js 18+ is downloaded automatically if not present

What happens when you connect

1. Your token is validated against the server
2. A secure WebSocket connection is established
3. claude (Claude Code CLI) is launched in your terminal
4. Your terminal output is streamed to the instructor's dashboard (read-only)

Options

Usage: keerok-lab connect <token> [options]

Arguments:
  token                 Connection token provided by the instructor

Options:
  -s, --server <url>    Server URL (default: "https://keerok.tech")
  -c, --command <cmd>   Command to run (default: "claude")
  -h, --help            Display help

Security

• Your API key is encrypted (AES-256/Fernet) and never stored in plain text
• The key is only active during the session and revoked automatically when it ends
• The instructor sees your terminal in read-only mode (no write access)
• No personal data is kept after the session ends

How It Works

Student terminal                Keerok Server              Instructor dashboard
     │                              │                              │
     ├── validate token ──────────► │                              │
     │◄── session config ─────────  │                              │
     │                              │                              │
     ├══ WebSocket ═══════════════► │ ◄═══════════════ WebSocket ══┤
     │                              │                              │
     │   terminal output ─────────► │ ──── terminal stream ──────► │
     │                              │                              │
     │◄── instructor message ────── │ ◄── send message ───────────┤
     │◄── budget warning ────────── │                              │
     │◄── session ended ─────────── │ ◄── end session ────────────┤

License

MIT