Get the app
Download it from cleve.ai/download. In the web app on a Mac, you can also open the account menu and choose Get the Mac app.- The app needs a Mac with Apple silicon and macOS 12 or later.
- Windows and Linux: there is no desktop app for Windows or Linux yet. On those, use Cleve in the browser at app.cleve.ai. Local folders and running Claude Code or Codex on your own plan need the Mac app.
- The app updates itself. When an update is ready it asks you to Restart now or Later. To check by hand, choose Check for Updates… in the app menu, or click Check for updates in Settings → General.
Start with a folder or your Cleve docs
The welcome screen gives you three ways in:- Open folder. Pick any folder of Markdown files, an Obsidian vault, or an empty folder to start fresh. No account is needed.
- Sign in to Cleve. The app opens your browser to a page called Connect the Cleve desktop app. Check that the page shows the same code as the app, then click Connect.
- Open your Cleve docs. After you sign in, your workspace opens as a folder on your Mac at
~/Cleve/<workspace name>and stays in sync with Cleve on the web and on your phone.
Sync a local folder
A folder you open yourself stays on your computer until you choose to upload it.- Sign in to Cleve.
- In the sidebar, click Upload to Cleve.
- In Upload this folder to Cleve?, choose where it goes, then click Upload and sync. To leave it local, click Keep it on this computer.
Syncing is optional. A folder you do not connect never leaves your computer.
Use Claude Code or Codex with your own plan
Open chat with⌘J and pick an agent:
Claude Code and Codex are separate programs from Anthropic and OpenAI. Cleve uses the copy already installed on your Mac, with the sign-in you already have there. Cleve never sees your login.
To set them up:
- Claude Code: install it, then run
claudein Terminal and sign in. - Codex: install it, then run
codex loginin Terminal.
Using your own Claude or ChatGPT plan works only in the Mac app, because the agent has to run on your computer. In the browser and on mobile, chat uses Cleve AI. To use your Cleve docs inside the Claude or ChatGPT apps instead, see Use Cleve in other AI apps.
Choose how much the agent can do
Each chat has a mode, shown next to the model under the message box. Click it to switch:- Ask first. Asks before it changes anything.
- Accept edits. Changes docs in your folder without asking, and asks before changing anything else.
- Plan. Reads and plans, and changes nothing.
- Full access. Never asks.
What the agents know about Cleve
Claude Code and Codex read Cleve’s help pages, so you can ask them how to do something in Cleve. When you ask to connect an app such as Notion or Linear, they show the same Connect card Cleve AI does. Apps you connect are used by Cleve AI; to work with them, start a chat with Cleve AI. When an agent names a doc in its reply, click the name to open the doc.Queue messages while it works
You can keep typing while an agent replies. PressEnter to add your message to the queue, or ⌘Enter to send it now. Queued messages can be edited, removed or sent with Send now. Click Stop to end the reply.
You can run several chats at once. They are saved with the folder.
Check on your agents from your phone
Turn on Remote control to see your Claude Code and Codex chats in the Cleve app on your phone, send them messages and answer their questions.Shortcuts
To make the sidebar or the chat panel wider, drag its edge. The app remembers the width. Click the sidebar’s edge to hide it.
What needs an account
- No account: opening and editing local folders, the Brain graph, skills stored in the folder, and browsing the marketplace and adding skills from it.
- Signed in: sync, Cleve AI, voice (dictation, meeting recording and voice to chat), comments, Memory, connected apps, adding docs from the marketplace, and remote control.
Related
Remote control
Work your Mac’s agent chats from your phone.
Use Cleve in other AI apps
Connect Cleve to Claude, ChatGPT, Claude Code and Codex.