Support — One

One is in beta, so things will occasionally go sideways. Most problems are a permission that did not stick; the rest we would like to hear about.

Get in touch

Email support@getone.one. Include your macOS version, the One build number (One menu → About), and, if you can, a short description of what you said and what happened. We read everything; replies can take a day or two during the beta.

Requirements

macOS 13 Ventura or later. macOS 14+ is recommended.
Apple silicon & Intel. The app ships as a universal build.
A Google account to sign in, and optionally a ChatGPT account if you want Codex to run on your ChatGPT plan.
At least one coding agent installed: Claude Code, Codex, OpenCode, or Pi.
herdr (optional, recommended) to run agents in managed terminal panes. Install it from the docs at herdr.dev; One will start herdr server for you when it needs it.

Permissions One asks for

All four are granted in System Settings → Privacy & Security. If a feature stops working, this is the first place to look.

Permission	Why	If it is missing
Microphone	Records the utterance you speak during a turn.	The pill shows a flat waveform and nothing is transcribed.
Screen Recording	Takes one screenshot per turn so the model can see what you are pointing at.	Turns fail with “screencapture failed”, or One cannot see the window you mean.
Accessibility	Makes the Option (⌥) double-tap work from any app and lets One type into terminals.	The gesture only works while One is in front, and typing into agents does nothing.
Automation	Lets One talk to your terminal app (Terminal, iTerm, Ghostty, and so on) to find and focus agent panes.	Agents outside herdr are not detected, or the wrong window is focused.

Quick troubleshooting

The Option double-tap does nothing

Double-tap ⌥ quickly, on its own, without holding it.
Check Accessibility: System Settings → Privacy & Security → Accessibility → One must be listed and switched on. After an update, macOS sometimes keeps the old entry: remove One from the list with “−”, then add it again.
Make sure another utility is not already capturing the Option key (some window managers and text expanders do).

Screen Recording keeps asking again

On macOS 15 and later, Apple re-confirms Screen Recording roughly once a month and after every new build. Click “Continue to allow” when the dialog appears. If the toggle looks on but captures fail, turn it off and on again, then quit and reopen One.

“Not signed in” or the pill will not connect

Open One and sign in again with Google. Sessions expire after 14 days without use.
If you are on a corporate network, make sure api.getone.one is reachable.

Codex says the ChatGPT account is not connected

Reconnect from One’s settings; the OAuth token lives in your Keychain and is dropped when you sign out. If Codex works in a terminal but not through One, run codex login once in the terminal and try again.

One cannot see my agent

Agents running inside herdr panes are always detected. For agents in a plain terminal, One needs the Automation permission for that terminal app and reads the agent’s own session files (~/.claude, ~/.codex, OpenCode, Pi).
If the herdr server is stuck, run herdr server stop in a terminal and let One start it again.

Logs and reset

Logs. One writes to the unified log. Open Console.app, select your Mac, and filter for com.kyzo.one; or run log show --last 10m --predicate 'subsystem CONTAINS "com.kyzo.one"' in a terminal. Attach the relevant lines to your email.
Reset. Quit One, then move ~/.config/one/ aside (older builds: ~/.config/agentpill/). Reopen One and go through onboarding again. Your history, work memory, and recaps are in that folder; keep a copy if you want them back.
Reset permissions. tccutil reset All com.kyzo.one clears every grant so onboarding can ask for them fresh.

How to uninstall

Quit One from the menu bar.
Move One.app from Applications to the Trash.
Optionally remove what the app leaves behind:

~/.config/one/ — settings, history.json, memory.md, and recaps.json (older builds used ~/.config/agentpill/).
Keychain items under the service name com.kyzo.one (One Dev builds use com.kyzo.one.dev). Open Keychain Access, search for kyzo, and delete them.
Privacy grants for Microphone, Screen Recording, Accessibility, and Automation. macOS keeps them after the app is deleted; remove One from each list in System Settings → Privacy & Security, or run tccutil reset All com.kyzo.one.
herdr is separate software and stays installed. Its background server may keep running after One quits; stop it with herdr server stop, and uninstall herdr by following its own docs.
Temporary screenshots in the system temp folder are deleted automatically after 10 minutes and on reboot.

Uninstalling does not delete your account. To have your account and data removed from our servers, email support@getone.one from the address you signed in with. See the Privacy Policy for what we hold.