What is threadle?

threadle turns every AI coding session on your machine into a node you can inspect, wire, and run.

Your agents already write everything down — transcripts, tool calls, token counts, the files they touched. Almost nobody reads it. threadle reads it, draws it, and lets you wire it into the next run.

It serves a local UI on 127.0.0.1:4570, discovers sessions from Claude Code, opencode, and Cursor Agent, and stays strictly read-only against their storage.

Three things it does


See	Every session, subagent run, and agent definition — with transcripts, files touched, context pressure, tokens and cost.
Connect	Distill a session into a brief and inject it into a different tool. Context becomes a first-class object you can reuse, tag, and trace.
Run	Wire agents, prompts, gates and custom nodes into a graph, press ▶, and watch it execute — in parallel, with human checkpoints and circuit breakers.

Is this for me?

threadle is useful if you:

run more than one agent CLI and keep re-explaining the same context to each of them
want to know what a session actually cost and did, not just what it said
have a repeatable multi-step process (plan → implement → review) worth wiring once
like ComfyUI’s canvas and want the same feel for coding agents

It is not an agent, a model, or a cloud service. It never sends your code anywhere; it drives the CLIs you already have installed.

Quick start

git clone https://github.com/threadle-sh/threadle && cd threadle
npm install
npm run build
npm start          # opens http://127.0.0.1:4570

Your existing sessions appear on first launch — nothing to import, nothing to configure.

See Install for prerequisites and flags.

Where to go next

You want to…	Start at
Build your first workflow in 5 minutes	Quickstart
Understand the app’s views	Tour
Learn the whole thing, in order	Learning path
Understand the canvas model	Graph & wires
Run a real job (diff review, handover, …)	Recipes
Run workflows headlessly	CLI
Know what it costs	Costs & billing
Check what it touches on disk	Trust model

The name

A treadle is the pedal that drives a loom. Sessions are the warp — the threads already strung on the frame. Your wires are the weft, crossing them into something whole. Press ▶ and you work the treadle.