Using Threadbear

Threadbear is a Mac app for running AI agent threads. It drives the official Claude Code and Codex command line tools on your own logins. A small program called the runner keeps every agent going in the background, so quitting or updating the app never stops a thread. Your threads are also copied to a Convex deployment of your own, which is how the iPhone app and the website can follow along.

This guide is for using it. INSTALL.md covers setting it up, and docs/ has how it all works inside.

  1. Threads
  2. Full access or Ask before edits
  3. Your first thread
  4. Hibernate and archive
  5. Panels
  6. Highlights
  7. Schedules
  8. Accounts, pools and Usage
  9. Connectors
  10. The prompts macOS shows you
  11. Your phone and a browser
  12. Patches: your own buttons and panels
  13. Changing Threadbear itself
  14. Privacy
  15. Getting help
  16. The tour and Finish setting up