To report a bug or ask for a feature, open an issue on GitHub. For anything else, email [email protected].
Include your Tidy version, your Mac model, your macOS version and what happened. A screenshot helps. Never send a recording or transcript with private details in it.
What do I need?
A Mac with Apple Silicon (M1 or newer) and macOS 14.4 or later. There is no version for Intel Macs.
How do I install Tidy?
Download the DMG from the latest release on GitHub, open it and drag Tidy into Applications. Tidy is signed with a Developer ID and notarised by Apple, so it opens like any other app.
How do I update Tidy?
Tidy offers updates inside the app when a new version is out.
Where is my workspace stored?
In a SQLite database on your Mac. To keep your pages as Markdown files too, turn on the vault in Settings › Markdown vault and choose a folder. Tidy mirrors your pages to it.
How do I set up the local AI?
Local AI is built into Tidy, so you do not need another app. Download a Whisper model for transcription in Settings › Transcription models. Download Qwen 3 for notes and answers, and Nomic for meeting search, in Settings › Local AI. Ollama is optional.
How does Tidy know when to record?
When Zoom, Teams, FaceTime, Slack or a browser starts using the microphone, a small window asks whether to record and reminds you to tell everyone. Nothing records until you choose Record.
Why does macOS ask for microphone and screen-recording permission?
Tidy records your microphone and the other side of the call separately, so it needs the microphone, system audio and screen-recording permissions. It uses them only to record meetings you start. If you said no earlier, allow Tidy in System Settings › Privacy & Security.
When does a recording stop?
When the call ends, after 3 minutes of silence, or 5 minutes after its calendar event ends.
Why is everything I say labelled You?
Tidy records your microphone and the other side of the call separately. Your words are labelled You, and only the other side is split into speakers.
How do I name speakers?
Name them from the meeting's notes after the call. Tidy also works names out from the conversation, for example when someone is asked "What do you think, Tom?" and then answers. With Use my calendar on, the meeting's invitees are suggested as names.
Can Tidy get names from Teams or Google Meet?
Yes, from Tidy 0.7.0. Turn on Settings › Recording › Names from Teams and Google Meet, then allow Tidy in System Settings › Privacy & Security › Accessibility. While you record, Tidy reads the call window to see who joined and who is shown speaking, and names the speakers after them. Clear matches are filled in and others are suggested in Name speakers.
In Google Meet, turn on captions so Tidy can see who is speaking. Teams does not need captions. Tidy keeps only names and times, never what the captions say, and it does not read other apps or browser tabs.
If no names appear, check that Tidy is still allowed under Accessibility. Teams and Google Meet sometimes change how their windows are laid out, and Tidy then names speakers from the conversation as before.
Names are spelt wrong in the transcript
Tidy spells names using the meeting's client, its invitees and the Names and terms setting. Add the names and words you use in Settings › Recording › Names and terms.
Can I play a meeting back?
Only if you turn on Keep meeting audio in Settings › Recording before the meeting. Then the play button above the notes plays the meeting, and clicking the map of who spoke when, or the time on a point, jumps to that line of the transcript and plays from there. Without the audio, the time and the map still jump to the line.
Can I tick off next steps?
Yes. Each next step in a meeting's notes shows who is doing it and by when, with a circle to tick once it is done. Ticked steps stay ticked if the notes are written again, and they are left out of what the next meeting like it shows as still open.
How do I mark a moment?
Press Control-Option-M in any app while you record.
Can I trust the notes?
Tidy writes the notes from the whole meeting, then checks every point against what was said when it was said: the names, numbers and people given tasks must be there. Points that cannot be backed up are left out. Notes can still miss things, more so on smaller models. Click the time on any point to check it against what was said.
How do I ask about past meetings?
Open Ask meetings and type. The meetings whose notes mention your words appear straight away, by date, with the words marked. Press Ask for an answer that links every claim to its source. Choose a client to ask across all of their meetings. Tidy understands dates such as "last week". Record follow-up meetings under the same client so they can be searched together.
How do I use my calendar?
Turn on Use my calendar in Settings › Calendar. Tidy then shows your next meeting on Home with a Record button, names recordings after their events, suggests invitees as speaker names and shows what earlier meetings like it decided and left open. It reads your calendar through macOS, on your Mac only.
Is there a dark mode?
Yes. Tidy follows your Mac's appearance, or you can choose Light or Dark in Settings › Appearance.
How do I connect Claude Code or Codex?
Tidy includes an MCP server that lets these tools read and search your workspace. Set it up in Settings › Agent connection (MCP). Anything a connected tool reads is sent to that tool's provider.