# amosblomqvist/learnharness

> LearnHarness is an app for learning difficult subjects, using AI agents to plan and teach lessons from your current understanding to a goal you set. The agents first measure where your understanding ends, then build a dependency map from that point to the goal and teach each step on top of what you already know. It is written mainly in TypeScript and runs as a desktop app on macOS, Windows and Linux.

Source: https://github.com/amosblomqvist/learnharness
Indexed: commit cb25c8e on 2026-11-13 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: TypeScript
- Stars: 10,065 at index time
- License: AGPL-3.0
- Code health: 7.8/10, Good
- Last commit: 2026-11-12
- Contributors: 42

## Install

From the README: https://github.com/amosblomqvist/learnharness

Clone the learnharness repository.
    git clone https://github.com/amosblomqvist/learnharness.git

Move into the learnharness folder.
    cd learnharness

Install the dependencies.
    npm ci

Set up the plugins.
    npm run plugins:setup

Start the development server.
    npm run dev

Run the tests.
    npm test

## How it works

The Electron entry point electron/main.cjs opens the desktop window, runs the local server and holds sign-in state for ChatGPT and subscription accounts. The app directory defines the screens, including the home page, the new session page, the chat and the settings. The components directory holds the React interface, and components/chat.tsx runs the session while drawing the transcript from shared widgets. The agent logic lives under src/agent, where src/agent/subagents/extraction.ts works on extracting material for the lesson. The plugins directory contains feature projects such as flashcards and a drawing pad, each with its own src/main.ts or src/main.js entry point. The root config.ts sets where the app keeps its data and provides the path table and thinking-level type that src/agent, src/store, src/server and src/core import.

- electron/main.cjs: entry point
- plugins/coding-questions/src/main.ts: entry point
- plugins/drawing-pad/src/main.ts: entry point
- plugins/flashcards/src/main.js: entry point
- plugins/rich-code-blocks/src/main.ts: entry point
Modules: tests, src, components, plugins, app, scripts, electron, root. 1,169 files, 162,893 lines, 7,329 symbols.

## Code health

- Score: 7.8/10 (Good)
- Trend: 7.3 on 2026-11-10, 7.8 on 2026-11-13
- Rank: #82 of 4,000+ indexed repos
- Hotspots: components/chat.tsx, src/agent/subagents/extraction.ts, components/graph-view.tsx, components/graph-canvas.ts, src/core/prices.ts
- Lowest file: components/session-core.ts
- Dead code: 30 findings

## Maintenance

- Last commit 2026-11-12, 949 commits
- 42 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/amosblomqvist/learnharness/security

## More

- Page: https://repowise.dev/repo/amosblomqvist/learnharness
- Ask this codebase: https://repowise.dev/repo/amosblomqvist/learnharness/chat
- Docs: https://repowise.dev/repo/amosblomqvist/learnharness/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/amosblomqvist/learnharness
