The short version
- ThreadGrid is a Mac app that runs on your computer. No ThreadGrid server does the work, and you don't need an account.
- A ThreadGrid account is optional. If you sign in, it holds your email, name and picture and the Macs you link, and, only for the projects you choose, a copy of their work and team. Never your code, agent transcripts, secrets or file paths. Details.
- Your projects, threads, tasks, transcripts and settings stay on your Mac in
~/Library/Application Support/ai.threadgrid.desktop. - Your teammates' work goes to Anthropic through your own Claude Code, or to OpenAI through your own Codex for teammates you put on Codex, under your accounts and their terms. Sign-ins for the Claude and Codex accounts you add stay on your Mac, in the Keychain and ThreadGrid's folder, and are never sent to threadgrid.ai. Details.
- Crash reports are off by default. If you turn them on, they're scrubbed of your content before they leave your Mac.
- This website has no analytics or trackers. Only the dashboard, if you sign in, uses cookies.
What stays on your Mac
ThreadGrid keeps its data in ~/Library/Application Support/ai.threadgrid.desktop: a local database with your projects, threads, team, tasks, comments, agent transcripts, decisions waiting for you, activity, usage and settings; the git worktrees your team builds in; each project's knowledge docs (mission, roadmap, decisions and notes); the reference files you attach to tasks (outside the repository, never uploaded to threadgrid.ai); and log files. Your projects themselves live wherever you keep them (new ones go in ~/ThreadGrid by default). When work ships, the knowledge docs are also written into your repository under .threadgrid/.
Secrets ThreadGrid needs to store, such as your Coolify API token, are kept in the macOS Keychain, never in the repository or the database. The sign-ins of Claude and Codex accounts you add in Settings → Accounts stay on your Mac too, in the Keychain and in ThreadGrid's folder above (see below). Deleting a project in the app doesn't touch your repository. To remove ThreadGrid's data entirely, remove any Claude or Codex accounts you added (which signs them out), quit the app and delete the folder above; a saved Coolify token can be removed in Keychain Access.
Claude, Codex and your accounts
Agent sessions run through the command-line tools installed on your Mac: Claude Code, signed in with your own Claude subscription or Anthropic API key, and, for teammates you put on Codex, OpenAI's Codex CLI, signed in with your ChatGPT plan or OpenAI API key. The prompts, your code and the results travel between your Mac and Anthropic or OpenAI exactly as they do when you use those tools yourself, and each handles them under its own terms and privacy policy.
ThreadGrid asks these tools for their version, which account is signed in, and each account's 5-hour and weekly usage; reading usage doesn't send a prompt. The sign-in you already use stays where Claude Code or Codex keeps it. Accounts you add in Settings → Accounts sign in through your browser, and their sign-ins are kept in the macOS Keychain and in ThreadGrid's folder on your Mac. ThreadGrid never sends any of these sign-ins to threadgrid.ai, with or without a ThreadGrid account, and these accounts can only be added, changed or removed on the Mac itself, not from the web.
Other services you connect
- GitHub. Pull requests, releases and repositories go through your own GitHub CLI (
gh) and your own sign-in. Pushes use your git setup. - Coolify. If you set up deploys, ThreadGrid calls the Coolify server you configure, with the token from your Keychain, and checks the health URL you give it.
- 21st.dev and other MCP servers. If you've configured the 21st.dev MCP in Claude Code, the teammates you enable use it with your key, which stays in your own configuration. Other MCP servers are only used if you allow them.
Claude teammates can also use the web and network tools Claude Code provides while they work, just as Claude Code can when you use it directly. Codex teammates work in Codex's sandbox with the network off.
Update checks
To keep itself up to date, the app fetches downloads.threadgrid.ai/mac/latest.json shortly after launch and every few hours, and downloads updates from the same place. Like any web request, this reveals your IP address to the service that hosts the files (Cloudflare). It doesn't include anything about you or your work.
Crash reports
Crash reports are off by default. You can turn them on in Settings → App → Privacy → Send crash reports, and off again at any time. When they're on and ThreadGrid hits an unexpected error, it sends a report to ThreadGrid's own, self-hosted error tracker.
A report contains only:
- the type of error and a scrubbed error message (at most 300 characters);
- stack positions (function names, line and column numbers) in ThreadGrid's own code;
- the app version, whether it was the engine or the interface, the macOS version and the runtime version;
- a random report ID and the time.
Before a report leaves your Mac, the message is scrubbed: tokens, keys and passwords, anything in quotes or backticks, URLs, email addresses, file paths, IP addresses, IDs and other long random strings are removed. File locations outside ThreadGrid's own code are replaced with a placeholder. Reports never include prompts, code, diffs, transcripts, file or project names, your name, your computer's name or who you are. ThreadGrid sends at most 25 reports per launch and collapses repeats of the same error.
Accounts (optional)
You can use ThreadGrid without an account. If you want to direct your team from your phone or another computer, you can sign in at threadgrid.ai/app and in the app (Settings → Accounts). Here's what that involves.
- Signing in. With a one-time code sent to your email, or with GitHub, Google or Apple. From those we receive your email address, name and profile picture, and nothing else: no access to your repositories, contacts or files. Sign-in codes are sent through our email provider, Resend. We don't send marketing email.
- What your account holds. Your email, name and picture; your sign-in sessions (with the IP address and browser they came from, to keep your account secure); and the Macs you link: the name you give each one, its macOS version, chip and ThreadGrid version, when it was linked and last online, and whether you allowed control from the web.
- Control from the web. Off until you turn it on for a Mac. Then browsers signed in to your account can see that Mac's threads and work and direct its team. Their requests and your Mac's answers pass through our relay, which forwards them and stores none of it. Your Mac decides what's allowed: the web can't run commands, change check commands, open things on your Mac or read secrets, and whatever is done from the web is marked “from the web”.
- Copies in your account. Off until you turn it on for a project. Then your Mac keeps a copy of that project's profile, team, tasks, comments, decisions, recent activity, ship records and usage totals in your account, so you can see where things stand while the Mac is offline. Code, diffs, agent transcripts, check output, secrets and file paths are never uploaded.
- Deleting. At threadgrid.ai/app/account you can remove a Mac (which signs it out and deletes its copies from your account), remove a single project's copy, or delete your account and everything stored for it. Turning sync off for a project in the app also deletes its copy. Signing out in the app unlinks that Mac.
- Where it lives. On servers ThreadGrid runs, behind Cloudflare. Errors in our own service may be reported to our self-hosted error tracker, scrubbed the same way as the app's crash reports.
No analytics
ThreadGrid has no license check and no usage analytics. Without an account we don't know who you are, and with one we know only what's listed above: not how you use the app or what you build with it.
This website
threadgrid.ai's pages are static. They set no cookies, use no analytics or tracking scripts, and load no third-party content. The dashboard at threadgrid.ai/app sets a sign-in cookie when you sign in, plus a small cookie that tells these pages you're signed in (so the header says Dashboard instead of Sign in); neither is used for anything else. Requests to the site and to downloads.threadgrid.ai pass through Cloudflare, which processes technical data such as your IP address to deliver and protect them. If you email us, we use your message only to reply.
Changes to this policy
If ThreadGrid starts handling data differently, we'll update this page and the date at the top before the change ships, and note it in the changelog.
Contact
Questions about privacy? Email [email protected].