Documentation

CLI Commands

Complete reference for the v0.1.8 command surface.

Release Notes

Phase 3 commands are now documented.

The CLI now supports claim review, source deletion, versioned export/import merging, and opt-in YouTube visual inspection. The docs below match the current shipped behavior rather than the older pre-Phase 3 flow.

Command Overview

Command	Description
/add <source>	Add a YouTube video, article, GitHub repo, or PDF path/URL.
/study	Start the current due session. Press Enter on an empty prompt as a shortcut.
/stats	Show sources, concepts, due count, review stats, and mastery progress.
/list	List active concepts grouped by source.
/due	Show what is currently due for review.
/skip <name-or-id>	Skip a concept during normal review rotation.
/unskip <name-or-id>	Restore a skipped concept.
/claims <name-or-id>	View, generate, edit, or delete cached claims for a concept.
/delete <source-or-id>	Delete a source and all associated concepts after confirmation.
/export [file]	Export a versioned JSON backup. Supports paths like ~/learnlock-export.json.
/import <file>	Validate and merge a JSON backup into the current database.
/visual [name-or-id]	On-demand YouTube frame inspection for the last reviewed or selected concept.
/config	Show the active data path, models, and API key availability.
/clear	Clear the screen and re-render the LearnLock banner.
/help	Show the built-in help text.
/quit	Exit LearnLock.

High-Leverage Workflows

Add and Study

learnlock> /add https://youtu.be/kCc8FmEb1nY
learnlock> /study

Type 'skip' to skip, 'q' to quit.
Press Enter twice to submit each answer.

Review or Fix Claims Before Studying

learnlock> /claims 12

edit 2 Attention weights come from the query-key dot product.
delete 4
done

You can target concepts by name or numeric id. If claims do not exist yet, LearnLock now generates them on demand.

Safe Backup and Merge

learnlock> /export ~/learnlock-backup.json
learnlock> /import ~/learnlock-backup.json

Imports are validated before touching the database and merge existing sources, concepts, progress, duel memory, and cached claims.

Inspect the Visual Context

learnlock> /visual
# or target a concept directly
learnlock> /visual 18

/visual is opt-in and only applies to YouTube concepts with transcript timestamps. It uses Gemini Vision to describe the linked frame.

Flags

Flag	Description
--gentle, -g	Force the softer HUD and supportive feedback mode.
--version, -v	Print the installed LearnLock version and exit.

New installs start in gentle mode automatically until you have 5 successful reviews. Use --gentle to force that mode even after you graduate to the full HUD.

Aliases

/list also works as /ls.
/help also works as /h and /?.
/clear also works as /cls.
/quit also works as /exit and /q.

Study Sessions