Skip to content

Latest commit

 

History

452 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ThoughtDAG logo

ThoughtDAG

Your thinking deserves a map. An infinite canvas where LLM conversations grow into an editable thought graph.

License Status

中文 · Quick start · How it differs · Research · Models & privacy

Hero demo, recorded from the live app: selecting a passage in the PDF reader and asking about it; deleting a noise edge and regenerating a clean answer; zooming out through three semantic tiers to the map; opening the backup control center and exporting a real file

YouTube thumbnail for the ThoughtDAG narrated tour

▶ The 33-second narrated tour

The one rule

Wires are the context. What the model sees is exactly what wires into the node. Editing the graph edits the model's memory.

Many tools put conversations on a canvas. In ThoughtDAG, a wire is not decoration or an execution route. It determines what the model sees next.

In action

One principle behind every gesture: the human in the loop, the model on the wires. No autonomous agent redraws your graph.

Illustration: the research chain wired to a summary node, with the edge to a dinner node cut into a red dashed line

✂️ Delete one edge, get a different answer

The model sees only what wires in. Delete the noise edge, ask again, and the same prompt returns a clean answer. Reproduce it in chapter ③ of the example canvas.

📖 Read a paper into a map

Select a passage, ask right there. The answer lands on the canvas with its page number, and the p.N chip jumps back to the page. Finish the paper, and the map is drawn.

Illustration: a passage selected on the original page, a purple ask bubble beside it, the paragraph tagged p.3
Illustration: three takeaway plaques with ruled-out, decided and pivoted badges, linked by dashed lines

💎 Condense the graph, then zoom out

Merge nodes into one higher conclusion; weave your highlights into cited prose. Then zoom through full cards, takeaway plaques and an icon skeleton. The graph folds inward instead of sprawling.

How ThoughtDAG differs

Many products use nodes and edges, but the graph does a different job in each category.

Product category How it differs from ThoughtDAG
Linear chat Context follows one chronological thread; ThoughtDAG selects and merges visible paths.
Mind maps and whiteboards Edges organize ideas for people; ThoughtDAG edges also change model input.
Branching chat canvases They usually follow one inherited branch; ThoughtDAG can merge or prune several paths.
Workflow and agent canvases Edges run tasks and data; ThoughtDAG edges control conversational context.
RAG and automatic memory The system retrieves context automatically; ThoughtDAG makes the selection visible and editable.

ThoughtDAG is a user-authored context graph: incoming paths and explicit references form the next request, while excluded work stays visible on the canvas.

Quick start

Desktop app

Download, open, think. The download page detects your platform and gives you the right installer; Releases keeps every build. macOS builds are signed and notarized. Windows builds are not signed yet and may show a SmartScreen warning.

Run from source

npm install
npm run server    # LLM proxy :3001
npm run dev       # → localhost:5173
# No .env? Connect any OpenAI-compatible endpoint inside the app

Environment variables, local models and connection details → docs/setup.md

Browser demo

Want a ten-second look before installing anything? The hosted demo runs in the browser, and the example canvas needs no key. It is a feature subset: keyless web search, some direct-connection tools and the subscription bridge are desktop/local-only.

🧪 Research: Why editable context matters

Context Intervention Benchmark · Pilot v1

When misleading context enters an LLM conversation, how much of the affected path must be removed before the answer recovers?

68/72 cases recovered after deleting only the misleading source. 72/72 recovered after removing the contaminated subgraph.

This does not explain hidden model reasoning or rank models. It tests a narrower, observable claim: changing visible context changes the next answer.

📖 Read the first case study · 📊 Methodology and results · 💬 Suggest a model for the next run

More capabilities

Capability What it does
📤 Read-only share One link carries the whole graph: no account, no server storage
🧭 Staleness & replay Upstream edits mark the answers they invalidate; replay in dependency order, token estimate first
✂️ Clipping Select a passage or drag a rectangle in the reader; it becomes canvas material with page provenance
🔌 Any model Per-node pins that follow the line; text-only models read images through their companion text
🔒 Local-first Automatic folder backup writes real files; point it at a synced folder for cross-device

Full feature list (60+, grouped by area) → docs/features.md

Works beside your coding agent

Automatic folder backup keeps the canvas as a live .thoughtdag.json file in your project; Markdown export turns any context chain or selection into a plain .md. Coding agents can read either without a plugin, API or server.

Models, cost & privacy

Connect a local Ollama or any OpenAI-compatible endpoint. Built-in presets, subscription connections and environment variables are documented in setup.

  • The free model tier covers every feature; a local Ollama runs fully offline
  • In the desktop app everything lives on your machine: canvases, keys, documents; on the web demo, model traffic runs browser-direct and keys never touch the server
  • PDFs never leave your machine; only extracted text travels when you ask
  • The backup format stays backward compatible; Markdown export is the permanent escape hatch

Supporters

With gratitude to @andreilaiter, ThoughtDAG's first supporter, and to everyone helping this independent open-source project grow.

Support ThoughtDAG


The graph is acyclic. You are the loop.

MIT © 2026 Xia Chen · Roadmap · Feedback · Cite

About

Your thinking deserves a map: an infinite canvas where LLM conversations grow into an editable thought graph. Wires are the context.

Topics

Resources

Contributing

Stars

251 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages