Favorites
★ Favorites (Resources → Favorites) is a soft-link jump list. “open this place again.” It does not copy content. That stays with the Context library (payloads) and provider storage (sessions).
What you can favorite
Section titled “What you can favorite”| Kind | Points at | Identity |
|---|---|---|
| Workflow | A saved graph | graphId |
| Session | A discovered conversation | provider + sessionId |
| Library | A context payload | content hash |
| Skill | A SKILL.md (or skill dir) on disk | absolute path |
| Rules | A rules file on disk | absolute path |
| File | Any file threadle can open | absolute path |
Re-adding the same target is a no-op (deduped). New entries land at the top of the list.
Add & remove
Section titled “Add & remove”There are no list-row stars. Favorite or unfavorite from:
| Where | How |
|---|---|
| Workflows, Sessions, Timeline, Library, Skills, Rules, Files | Right-click → Add / Remove favorite |
| Session / Library / Files detail · Skills/Rules inspector | ★ favorite / ☆ unfavorite on the right |
| Favorites view | Right-click → Remove |
Empty state: right-click anything that supports it and choose Add to favorites.
The Favorites view
Section titled “The Favorites view”| Control | Behavior |
|---|---|
| Provider chips | Same chips as Sessions. Workflows have no provider. They hide when a provider filter is on. Skills / rules / files match a provider when the path looks like that tool’s home. |
| Kind chips | all plus each kind that has items. Sections are ordered A–Z by kind label (Files → Library → Rules → Sessions → Skills → Workflows). |
| Filter | Substring match on title, meta, and kind. |
| Prune missing | Shown only when some targets are gone. Drops dead entries after an alive check. |
Rows show title, optional dimmed missing chip, meta, and relative age. Click opens the target (no-op if missing). Missing rows are dimmed.
| Kind | Opens |
|---|---|
| Workflow | /graph/:id |
| Session | Session detail / blueprint entry |
| Library | Payload viewer |
| Skill / Rules | Skills or Rules view focused on that path |
| File | In-app file viewer |
Storage
Section titled “Storage”~/.config/threadle/favorites.jsonSchema { schemaVersion: 1, items: […] }. Override the config root with THREADLE_CONFIG_DIR. Included in threadle export --backup / UI Backup. See CLI and Files & config.
Alive checks (Favorites view and prune): workflow via the graph store, session via the provider adapter, payload via the payload store, skill / rules / file via fs.access.
| Method | Path | Notes |
|---|---|---|
GET | /api/favorites | { items } |
GET | /api/favorites?check=1 | each item includes alive: boolean |
POST | /api/favorites | create. 201 if new, 200 if already present |
DELETE | /api/favorites/:id | { items } |
POST | /api/favorites/prune | drop missing targets. { items, removed } |
Related
Section titled “Related”- Context library. Payloads vs jump-list bookmarks
- Tour. Where Favorites sits in Resources
- Files & config.
favorites.jsonon disk - CLI. Backup includes favorites
- Open files & context. What a favorited file opens into