Tour of the app

threadle is two apps on one local install and shared state (~/.config/threadle):

Viewer (threadle on :4570): sessions, spend, blueprints, search.
Workflows addon (threadle-workflows on :4571): canvas, runs, logs, custom nodes. UI under /addon/workflows.

Viewer-first: Sessions is the default. The Workflows addon opens in its own tab.

This page is the map. Each row links to the page that explains it properly.

Viewer · Review

	View	What it’s for
❯	Sessions	Every discovered session across all providers. Tokens, cache rate, cost, live status. Entry to blueprint and context growth.
◈	Map	One project as a graph: sessions, contexts, workflows, agents, rules, skills. See Map.
⌕	Search	Full-text search across every transcript and context payload. See Search.
⇄	Lineage	Which session fed which, through which payload, across tools. See Lineage.
≋	Timeline	Every session as a bar on one clock, provider-colored. See Timeline, diff & stats.
◍	Statistics	Tokens, cache economics, and costs. Grouped overall, then per provider.
⊙	Activity	Recent movement across your tools, newest first.

Viewer · Resources & system

Favorites, Library, Agents, Rules, Skills, Services, Files, Meta, Settings, Security (same as before). Settings → Addons → Workflows controls examples and opens the addon.

Sidebar Addons → Workflows (addon badge) opens threadle-workflows in another tab (or tells you to start it).

Workflows addon

Separate app. Soft-frozen. Paths under /addon/workflows. Full overview: Workflows addon.

	View	What it’s for
⌗	Workflows	Saved graphs, recipes and examples, import/export. Open one for the canvas.
◷	Runs	Every threadle job. Live and historical.
≣	Logs	Server + job log stream.
◇	Nodes	Custom nodes.

Start with Getting started on the canvas. Then Running and Graph & wires.

MCP

threadle mcp exposes saved workflows as tools and answers spend/session questions from inside an agent session. See MCP.