1. Conduid
  2. Documentation
  3. Clew
MCP server · Documentation

Clew

by · github.com/miuuyy/Clew

Clear path from where you are to what you want to learn. AI agent turns goals and topic dumps into graph with visible dependencies (generative roadmap.sh)

Unclaimed MIT ai-agentsgenerative-uigraphslearningllmmcpobsidianroadmapstudy
InstallView source
52Fair

Scored 3 hours ago · breakdown

About Clew

Clew is an MCP server published by miuuyy in the Documentation category: clear path from where you are to what you want to learn. AI agent turns goals and topic dumps into graph with visible dependencies (generative roadmap.sh).

The repository has 195 stars and 18 forks, with the last commit yesterday. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/miuuyy/Clew

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Clew

Powered by Claude · Grounded in docs

I know everything about Clew. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 2 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.

1 check has not been run yet.

Releases

v1.0.0Clew 1.0.0 · 2 Oct 2026Clew 1.0.0 Clew is now a desktop learning workspace for Windows, macOS and Linux. Install it, continue with ChatGPT, and start building your learning graph. Bundled Electron UI and Python runtime. No separate Python, Node, API key, or…
v0.2.1Clew 0.2.1 · 13 Jul 2026Explore your learning path in 3D. Clew 0.2.1 adds an optional 3D graph mode and makes starting topics easier to find. 3D graph mode Switch between the familiar 2D map and a fully spatial 3D view. Explore volumetric knowledge zones with…
v0.2.0-f2Clew 0.2.0 F2 · 11 Jul 2026Generate a learning map. Click any topic. Follow the thread. 0.2.0 takes Clew from a graph experiment to a product. Three big additions: Obsidian bridge in both directions, an MCP server so external assistants can read your graph, and a…
v0.2.0Clew 0.2.0 · 25 Apr 2026Generate a learning map. Click any topic. Follow the thread. 0.2.0 takes Clew from a graph experiment to a product. Three big additions: Obsidian bridge in both directions, an MCP server so external assistants can read your graph, and a…
v0.1.1fixv0.1.1 · 17 Apr 2026What's new Added the new light theme Improved and polished the UI across the workspace shell Fixed a range of bugs and regressions discovered during the theme and shell pass

README

Clew

Download · Docs · Contributing · MIT

A learning graph, powered by your ChatGPT plan.

Clew turns a goal, syllabus, or folder of notes into a map of topics and prerequisites. Click a topic to see the path behind it. Study with an assistant, review its proposals, and keep your progress attached to the graph.

Your graphs live on your computer. AI changes require your approval, and accepted changes can be rolled back.

Install

Download the build for your computer from Releases.

Platform Builds
Windows x64 installer
macOS 13+ Apple Silicon and Intel, DMG or ZIP
Linux x64 and arm64, AppImage or Debian package; see platform requirements

Open Clew and select Continue with ChatGPT. A ChatGPT Plus or Pro plan and permission to use that plan are required. You do not need Python, Node, an API key, or the Codex CLI installed.

GitHub stars and X follows are optional. They do not unlock features or change access.

The 1.0.0 downloads are not Developer ID notarized or Authenticode signed. macOS builds have an ad-hoc signature. See installation notes for platform requirements and data locations.

Help → Check for Updates opens the newer release's installer page. Updates are installed manually and retain local data.

Work through a subject

  1. Create a graph from your goal or import an Obsidian vault.
  2. Select a topic to inspect its prerequisites, resources, and notes.
  3. Ask the assistant to explain, quiz you, or expand the graph.
  4. Review a proposal and apply it when the structure makes sense.
  5. Finish a topic through the study workflow. Roll back a snapshot when needed.

Clew includes two graph views, Midnight and Paper themes, completion quizzes, Markdown and graph export, and a read-only MCP server for other assistants. The ChatGPT web plugin is a separate future integration; it is not part of this release.

Privacy and control

  • Graphs, snapshots, and conversation history are stored in a local SQLite database.
  • ChatGPT credentials stay in the operating system's credential store.
  • AI requests send the conversation and scoped learning context to OpenAI. They use your existing plan allowance.
  • Set Clew's weekly allowance in ChatGPT → Settings → Usage → App limits.
  • The model proposes changes. Clew validates them; you choose whether to apply them.
  • Sign-out locks the workspace interface without deleting local data.

Development

Requirements: Node 22.22.2+, Python 3.11+, and an OS credential store.

git clone https://github.com/miuuyy/Clew.git
cd Clew
cp .env.example .env
./scripts/dev.sh

Open http://127.0.0.1:5178. The browser development build uses the same ChatGPT entry screen. To run the Electron app, install its tooling and start it:

npm ci
npm run dev

For native Windows setup and release builds, see Desktop development.

npm run check:version
npm run test:desktop
npm --prefix frontend run typecheck
npm --prefix frontend run test
npm --prefix frontend run test:localization
npm --prefix frontend run build
PYTHONPATH=backend ./.venv/bin/python -m unittest discover -s backend/tests -v

Source map

Directory Owns
desktop/ Electron lifecycle, local backend packaging, native builds and release checks
frontend/src/ Sign-in, graph workspace, proposal review and study UI
backend/app/agent/ ChatGPT authentication, Responses requests and typed tools
backend/app/services/ SQLite repository, snapshots, validation and grading
contracts/ Graph operation and proposal contracts
docs/ Engineering documentation
docs/site_faq/ Product documentation source

Read Architecture and Project Context before changing product behavior.

README fetched from the repository 2 hours ago. The original is authoritative.

Questions

About Clew

How do I install Clew?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Clew safe to use with an AI agent?

Its trust score is 52 out of 100 (fair). It passes 5 of the 5 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Clew still maintained?

Yes — the latest release is v1.0.0 (2 Oct 2026), and the last commit was yesterday. The repository has 195 stars.