Skip to main content
Cleve for Mac is a desktop app that opens a folder of Markdown files, such as an Obsidian vault, in the Cleve editor. Your docs stay on your computer as plain files. You can use it with no account, or sign in to sync with your Cleve workspace. It is also where you use Claude Code and Codex with your docs. Those agents run on your Mac with your own Claude or ChatGPT plan, so they don’t use your Cleve AI usage.

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.
  1. Sign in to Cleve.
  2. In the sidebar, click Upload to Cleve.
  3. 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.
The upload runs in the background. After that, changes sync both ways. To stop, open the sync window and click Stop syncing here. You can review this in Settings → Sync.
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 claude in Terminal and sign in.
  • Codex: install it, then run codex login in Terminal.
Then open Settings → Agents in Cleve and click Look again. The agent shows as ready once Cleve finds it installed and signed in.
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.
When an agent asks for permission, choose Allow, Allow for this chat, Decline or Always allow. Always allow switches the chat to Full access so it stops asking. New chats start in the mode you used last, so switch back to Ask first under the message box whenever you want it to ask again.

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. Press Enter 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.
Plans are bought in the browser, not inside the app. See Plans.

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.