Skip to content
Threadbear
What it does How it works FAQ Docs
Get Threadbear
  • Home
  • What it does
  • How it works
  • FAQ
  • Docs
  • Get Threadbear
Using Threadbear
  1. Threads
  2. Full access or Ask before edits
  3. Your first thread
  4. Hibernate and archive
  5. Panels
  6. Highlights
  7. Projects
  8. The librarian
  9. Schedules
  10. Accounts, pools and Usage
  11. Connectors
  12. The prompts macOS shows you
  13. Your phone and a browser
  14. Patches: your own buttons and panels
  15. Changing Threadbear itself
  16. Privacy
  17. Getting help
  18. The tour and Finish setting up

Projects

A project gathers the threads about one thing, whatever folder they ran in: an app you're building, a trip, a house move. Each has goals, a few lines on where it's up to, notes for later threads (decisions and gotchas), links (its live site, an admin page) and folders, the repos its work lives in. The Projects view lists them, with New project at the top; click one for its page, with its threads, state and notes.

A thread gets into a project in one of three ways: the librarian files it (below), its agent joins one, or you put it there, from Projects in its right-click menu. A thread can be in more than one. Its agent is told a little about each project it's in, and gets the panels and Patches from the projects' folders. If one is wrong, Take out in its Highlights keeps it out for good.

A project can show a task board from Notion. Give it a Notion page with a Tasks database on it (a board grouped by Status): Add Notion page… under Tasks on its page, Notion Page… when you right-click it in Projects, or ask an agent to. The page shows the board, read every few minutes, with a column per status and who and when on each card. Cards are moved in Notion, by you, anyone you share the page with, or the agents, who see the open cards and are told to keep them moving. A card whose Thread column names a thread links to it. A thread's Highlights shows a few of its projects' open cards under each project, its own card first. Boards are read through a Connectors gateway (see Connectors); without one, the project's page says so and nothing is read.

Next: The librarian

Threadbear is made by Mike Cann. It runs the official Claude Code and Codex command line tools, and isn't made by or connected to Anthropic or OpenAI.

Home How it works FAQ Docs Help Privacy mikecann.app