Reach a person
I reply within two business days, usually sooner.
Je réponds aussi en français.
From inside Treadle
Settings → This Mac → Create a diagnostic report.
It builds a report you can read before it's sent. It never includes what you wrote.
Phone
Montréal. If I can't pick up, leave a message and I'll call you back. Email is usually faster.
Getting started
What you need
- A Mac on macOS 13 or newer. Apple silicon and Intel both work.
- A paid Claude plan (Pro or higher). Treadle uses it to read your work and to run your agents, through your own account.
- Optional: ChatGPT or Codex, Notion, and a Google or Outlook calendar, if you use them.
1. Install Treadle
Open the download link on your welcome page or in your welcome email, open the file it downloads, and drag Treadle into your Applications folder. Then open it from Applications. The first time, macOS asks whether you want to open an app downloaded from the internet. Treadle is signed and checked by Apple, so it's safe to say yes.
Then activate it with your membership key: press Open Treadle on the welcome page you saw after checkout, or paste the key in Settings → This Mac → Membership. See Your membership key.
2. Claude Code, and signing in to Claude
Treadle talks to Claude through Claude Code, Anthropic's free tool. If it isn't on your Mac yet, Treadle's first screen says so and offers Install Claude Code: one press, about a minute, nothing to type. Treadle notices on its own when it's in.
Then the first screen offers Connect. It opens Claude's sign-in page in your browser. Approve it, and Claude Code keeps the sign-in. Treadle never sees or stores it. It lasts about a month. With a current Claude Code, Treadle tells you the week before it ends; if it ends anyway, Treadle says so and the same button signs you back in. You can see or redo it any time in Settings → This Mac → Claude.
3. Tell it where your work lives
Next, Treadle asks for the folders that hold your projects and three questions about your week. Then it does its first read in front of you, so you can see what it found. After that it reads again once a day when you open it.
Connecting your work
Everything below lives on the Integrations page. Each source has its own card, and you can switch any of them off.
Claude Code and Claude Cowork
Nothing to set up. Treadle reads the sessions Claude Code and Cowork already keep on your Mac: titles, timings, and short excerpts of your own messages. It turns them into progress on your board. Switch it off on the Claude Code card.
Your chats on claude.ai or in the Claude app's chat mode aren't on your Mac, so Treadle reads them from an export instead: see ChatGPT and Claude chats below.
Codex
Nothing to set up. If Codex is on your Mac, Treadle reads its session list and your own messages in it, and a ChatGPT chat you hand off to Codex. Switch it off on the Codex card. Your other chats on chatgpt.com are read from an export: see below.
Your project folders
On Integrations, under Projects, add a folder for each project, or watch the folder that holds them: every git repository directly inside a watched folder counts as a project. A folder without git counts once you add it, through the Claude Code, Cowork or Codex sessions opened in it. For projects that use git, Treadle reads the commit history as well, straight from your Mac. A project does not need to be on GitHub. Hide a folder to keep Treadle out of it entirely.
GitHub
Optional, and for work that isn't on your Mac: if you run Claude Code in the cloud, or your projects have no copy on this Mac, connect GitHub and Treadle reads those repositories too. On Integrations → GitHub (or in the welcome's projects step), make a fine-grained token with Contents: Read-only on the repositories you choose, paste it, and press Connect. The repositories you choose are all it can see.
Treadle reads each repository's commits from the last month and its claude/ branches, the ones cloud sessions push. It keeps the token in a private file on your Mac and never sends it to gettreadle.com. Disconnect deletes it.
ChatGPT and Claude chats
These chats live on the websites, not on your Mac, so Treadle reads them from an export you add once. Ask ChatGPT or Claude for an export of your data; it arrives by email. Then, on Integrations under ChatGPT and Claude chats, press Add an export and choose the .zip as it came, or the conversations.json inside it. Treadle reads your own messages, not the replies, and lists the work in them. A newer export replaces the older one.
Google Calendar or Outlook
Treadle reads your calendar from a private link that you paste on Integrations → Calendar. It reads each event's title and time, nothing else.
- Google: in Google Calendar's settings, choose the calendar, then Integrate calendar, and copy Secret address in iCal format.
- Outlook: Settings → Calendar → Shared calendars → Publish a calendar. Copy the ICS link, not the HTML one.
Treat that link like a password: anyone who has it can see your calendar. Treadle keeps it in a private file on your Mac and never shows it.
Notion
Notion takes four steps, all in Treadle and Notion.
- Go to notion.so/my-integrations (Integrations → Notion has a link), create an internal integration, and copy its secret.
- Paste it on Integrations → Notion and press Connect. Treadle checks it with Notion before keeping it in a private file on your Mac.
- In Notion, open the page that holds your work, then ••• → Connections → add your integration. Pages inside it are included.
- Back in Treadle, load your databases and pick one.
Your agents
The Team page holds a starter team of thirteen agents, each with its own job: Warp (Lead), Quill (Writer), Pattern (Marketer), Thread (Social), Needle (Researcher), Scales (Decider), Spindle (Builder), Shuttle (Shipper), Thimble (Watchman), Tack (Errands), Seal (Counsel), Swatch (Designer) and Reed (Reviewer). Warp sorts new steps and hands each one to the agent that fits. You can edit them or make your own.
- They ask first. The first time you send one to work, Treadle explains what agents can do and waits for your yes.
- They work on a copy. Code is changed in a separate copy of your project and left on its own branch. Writing (a draft, a list, a plan) is made in an empty folder. Nothing lands in your project until you merge or accept it.
- Results wait for you under Needs you, with what changed in plain words. Pictures appear when your project can show them.
- When one gets stuck, it asks you a question on the step. Answer there, and it carries on.
- Agents use your Claude plan's usage. They can read files on your Mac so they understand your project, but while they work they can only change files in their own copy.
Your membership key
Each membership has a key. It looks like TRDL.…, and it's how Treadle knows your membership is paid.
Where to find it
Right after checkout, Stripe sends you to a welcome page on gettreadle.com. It shows your key, a button to download Treadle, and an Open Treadle button. Keep the key somewhere safe. If you lose it, you can have it sent again below.
Activate Treadle
Press Open Treadle on the welcome page, and Treadle activates in one click. If the button doesn't open Treadle, open it yourself, go to Settings → This Mac → Membership and paste the key.
Staying active
About once a day, Treadle checks your membership with gettreadle.com. The check sends only your key and Treadle's version number. The privacy policy has the details.
- If Treadle can't reach gettreadle.com, or your card is declined while Stripe tries it again, Treadle keeps working for 14 days and says so in one line.
- Treadle needs to reach gettreadle.com at least once every 30 days. If it hasn't, the 14 days start then.
When a membership ends
A membership ends when you've cancelled and the period you paid for is over, when it's refunded, or when it's still unpaid after the 14 days. Your board then becomes read-only.
- You can still open Treadle, read everything, and export your board, a copy of your whole board as a JSON file, from the banner or from Settings → This Mac → Membership.
- Treadle stops reading new work and stops planning, and agents stop.
- Nothing is deleted. Renew, or enter a key that is paid, and Treadle picks up where you left off.
Resend my key
Type the email you used at checkout. If it has a membership, the key is emailed to you.
Billing
Payments are processed by Stripe through its Link service, which acts as the merchant of record. Your card details go to Stripe and never reach me. Charges appear on your statement as LINK.COM* TREADLE, and your receipts come from Link. Link's support can also help with a charge, at link.com.
Manage your subscription
Enter the email you paid with and Stripe sends you a code. From there you can cancel, change your card, or download your receipts. To switch between monthly and yearly, email me and I'll do it the same day.
Cancelling
You can cancel any time, on your own, from the billing page above. Cancelling stops the next charge, and Treadle keeps working until the end of the period you've already paid for, or until your free days end.
Refunds
If Treadle isn't useful to you in your first 30 days, email me and you get your money back, monthly or yearly, no questions asked. This is on top of any refund right the law or Link's own policy gives you.
Founding price
Founding members pay $20 USD a month or $200 USD a year, or $28 CAD a month or $280 CAD a year in Canada. That price stays the same for as long as your membership continues. The founding price is open until December 31, 2026. Members who join after that pay more. Taxes, where they apply, are shown at checkout.
When something goes wrong
“Treadle is signed out of Claude”
Press Reconnect on the banner and approve in your browser. This happens about once a month, when Claude Code's sign-in ends. Your board is untouched while it's signed out. Treadle simply waits.
It says it can't find Claude Code
Press Install Claude Code on the banner, or in Settings → This Mac → Claude. Treadle notices on its own once it's in; there's no need to quit it. If the button fails, open Terminal (Applications → Utilities → Terminal), paste this line, and press Return:
curl -fsSL https://claude.ai/install.sh | bashMy board looks empty after setup
Check that Integrations lists your projects, and add any folder it missed. Then go to Team and press Read now on the Keeper. A first read can take a few minutes on a busy Mac.
My calendar link won't load
Use the ICS link, not the HTML one. Outlook offers both side by side. For Google, use the secret address. The calendar card says in words what went wrong.
Notion shows nothing
The database has to be shared with your integration (••• → Connections). Notion gives an integration no access until you do, even to your own pages.
An agent stopped halfway
Open the step. The agent's question is waiting there. Reply, or press What would you do? to hear its suggestion, then Carry on. If a task is too big for one run, Split breaks it into smaller steps.
Something else broke
Go to Settings → This Mac → Create a diagnostic report. Treadle builds a report of what went wrong, never what you wrote, and shows you every line before anything is sent. It opens in your own email app. You press Send.
Your data
Treadle keeps your board on your Mac, in a folder in your home folder. There is no Treadle account. The only thing Treadle sends to gettreadle.com is a daily membership check, with your membership key and Treadle's version number. The full details are in the privacy policy.
Back it up
Copy the folder ~/.treadle-app somewhere safe. In Finder, press ⇧⌘G and paste that path to find it. Treadle also keeps one backup copy of your board next to it.
Delete everything
- Quit Treadle (⌘Q) and drag it from Applications to the Trash.
- In Finder, open your home folder, press ⇧⌘. to show hidden folders, and move
.treadle-appto the Trash, along with.treadle-app-copiesif it's there (Treadle's copies of code it read from GitHub). - If you installed the
/treadlecommand for Claude Code, also delete~/.claude/skills/treadle. - Optional: Treadle's own Claude runs are kept by Claude Code in
~/.claude/projects, in folders whose names containtreadle-app-agentororbital-work. Delete those folders too. Branches its agents left in your projects start withtreadle/(older ones withorbital/). - Empty the Trash.
Nothing of your work remains anywhere I can reach, because none of it was ever sent to me.