threadbear
A Mac app for running your Claude Code and Codex threads, on the subscriptions you already have. Comes with an iPhone app, and you get all the source.
What is threadbear?
A Mac app for running your Claude Code and Codex threads, on the subscriptions you already have. Comes with an iPhone app, and you get all the source.
Overview of threadbear
What it is
Threadbear is a Mac app for running Claude Code and Codex threads using the subscriptions you already have. It includes an iPhone app and provides all source code. The app uses your own Convex deployment for syncing, so no data runs on the developer's servers.
Key features
- Decisions: When a thread needs you, it presents choices as buttons.
- Options: When the agent is unsure about appearance, it shows several side-by-side options.
- Inbox zero: Working threads drop into Running and done ones archive with a click, keeping your inbox focused on what needs you.
- No project picker: Start a thread and the librarian files it into the correct project and keeps notes updated.
- On your phone: Syncs through your own Convex deployment, so your phone works when your laptop is asleep.
- Patches: A patch is a small TypeScript file that adds panels and buttons, and your agent can write one for you.
- Your own fork: You fork the code, so you can change anything. Updates come as daily releases and a thread brings them in.
Use cases
Threadbear is designed for developers who want to run Claude Code and Codex threads locally on their Mac, with the ability to continue threads on their iPhone. It is suitable for those who want full control over the source code and prefer to keep their data on their own infrastructure. The app can be used for coding tasks, project management, and any workflow that benefits from persistent agent threads.
Getting started
To install, you need a Mac with Apple silicon on macOS 26 or later, Xcode 26 or newer, Node 24 or newer, Claude Code or Codex installed and logged in, a free Convex account, and the GitHub CLI (gh). The easy way is to paste a provided command into Claude Code or Codex to let your agent handle the fork and installation. To do it yourself:shgh repo fork mikecann/threadbear --clonecd threadbear./threadbear setupAfter setup, open Threadbear and a short tour shows you around. For your phone, get Threadbear for iPhone and pair it from Settings > Phone & browser on the Mac.
License and pricing
The license is MIT, as stated in the repository. The fonts and icons under site/ keep their own licenses, as does Pele (MIT), the diagram library bundled in the Mac and iPhone apps.
Based on the project's public README and repository metadata.