Getting started

LearnOS is a hosted, multi-user workspace at learnosapp.com. You sign in, ingest courses, and study from the web app. If you want to drive LearnOS from Claude or a terminal, you can also issue a personal access token and connect over MCP or the CLI — both talk to your workspace at learnosapp.com on your behalf.

1. Create your account

Go to learnosapp.com and sign up with email + password or magic link. Your workspace is private by default; published courses on Discover live in a separate, opt-in catalog.

2. Add a course

From the web app, you can import a course in three ways:

• From a URL — paste a markdown URL or a curated preset (OSSU, The Odin Project, Teach Yourself CS, Microsoft Web Dev for Beginners). LearnOS fetches, chunks, embeds, and indexes the course on the fly.
• From a YouTube video — paste a YouTube URL; LearnOS captures the timestamped transcript and creates a video lesson searchable by section.
• From the Discover catalog — browse community-published courses at /discover and click Add to Library.

Whichever path you take, retrieval (keyword + semantic) is live the moment the course finishes importing — chat, search, and citations all work immediately.

3. (Optional) Issue a personal access token

A personal access token (PAT) is what you use to drive LearnOS from outside the web app — from Claude via MCP, or from the CLI.

1. Sign in at learnosapp.com.
2. Open Settings → Personal access tokens.
3. Click Create token, give it a name (e.g. Claude Desktop), and copy the token. It's shown once; treat it like a password.
4. Optional: set an expiration date and revoke any time from the same page.

Every call made with a token is recorded — you can audit usage from Settings.

4. Connect Claude (hosted MCP)

LearnOS exposes the same primitives the web app uses as a hosted Model Context Protocol server at https://learnosapp.com/mcp. Point Claude Code, Claude Desktop, or Cursor at it with your PAT in the Authorization header. See MCP install for client-specific snippets.

5. (Coming soon) The learnos CLI

A published learnos CLI is planned. It will talk to your hosted workspace using your PAT — no Supabase keys, no local database. See the CLI reference for the planned commands.