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, connect over MCP or the CLI — both sign in with your LearnOS account and 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

Browse the course catalog at /discover and click Add to Library. Chat, search, and citations work on the course right away.

3. 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. Add that URL to Claude Code or Cursor; on first connect your client opens a browser so you can sign in and approve access (OAuth). No token to copy. In Claude Code:

claude mcp add --transport http learnos https://learnosapp.com/mcp

See MCP install for other clients.

4. (CI only) Personal access tokens

For CI, or a client that can't open a browser, create a token in Settings → Personal access tokens. It's shown once; treat it like a password.

Personal access tokens carry full access to your account, expire after 90 days, and are checked by the app rather than by row-level security — use them only where OAuth isn't possible, and revoke them from Settings when you're done.

5. (Coming soon) The learnos CLI

A published learnos CLI is planned. It will talk to your hosted workspace after you sign in with learnos login — no Supabase keys, no local database. See the CLI reference for the planned commands.