Learning path
threadle has a small number of ideas that compose. This path introduces them in dependency order — each level assumes the one before it, and each maps to runnable examples bundled in the app under Workflows → Examples.
Work through it in an afternoon, or dip in at your level.
The four levels
Section titled “The four levels”| Level | You can… | Time |
|---|---|---|
| 1 · Beginner | Wire nodes, run an agent, gate a result, parameterize a graph | ~20 min |
| 2 · Intermediate | Merge branches, iterate over lists, mute/bypass, add breakers | ~30 min |
| 3 · Advanced | Run branches in parallel, build multi-agent pipelines, run headless | ~45 min |
| 4 · Expert | Extend threadle with custom nodes, ports and params; ship reusable graphs | open-ended |
How the examples work
Section titled “How the examples work”Every level has matching examples in Workflows → Examples. Clicking one clones it into your library — you get your own editable copy, not a read-only demo. Beginner and most intermediate examples need no agent at all, so they cost nothing to run.
The same graphs are runnable from the terminal:
threadle --list-templatesthreadle run hello-wire --approve-allIf you only read three pages
Section titled “If you only read three pages”- Graph & wires — the execution model
- Running — canvas, partial, and detached runs
- Costs & billing — what a run actually costs you
When you want to do something rather than learn a mechanic, jump to Recipes.
A note on cost while learning
Section titled “A note on cost while learning”Levels 1–2 are almost entirely agent-free by design: prompts, converters, knots, iterators and tripwires are pure local computation. You only start spending when you wire an agent node — and even then, tracked costs vs actual spend tells you exactly what was list price and what came out of your pocket.