> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleve.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cleve for Mac

> The desktop app, for Mac only (no Windows or Linux yet): local Markdown folders, optional sync, and agents that run on your own Claude or ChatGPT plan

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](https://www.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](https://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**.

> [!NOTE]
>
> 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:

| Agent | What it uses |
| - | - |
| **Cleve AI** | Your Cleve plan's AI usage. Needs you to be signed in to Cleve. |
| **Claude Code** | Your own Claude plan, not your Cleve AI usage. |
| **Codex** | Your own ChatGPT plan or API key, not your Cleve AI usage. |

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.

> [!NOTE]
>
> 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](https://docs.cleve.ai/integrations/mcp.md).

### 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](https://docs.cleve.ai/features/remote-control.md) to see your Claude Code and Codex chats in the Cleve app on your phone, send them messages and answer their questions.

## Shortcuts

| Shortcut | What it does |
| - | - |
| `⌘N` | New doc |
| `⌘O` | Open a doc by name |
| `⌘⇧F` | Search the text of every doc |
| `⌘E` | Switch between the editor and Markdown |
| `⌘J` | Open chat |
| `[[` | Link to another doc |
| `/` | Insert a block |

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](https://docs.cleve.ai/pricing/overview.md).

## Related

> [card] [Remote control](https://docs.cleve.ai/features/remote-control.md)
>
> Work your Mac's agent chats from your phone.

> [card] [Use Cleve in other AI apps](https://docs.cleve.ai/integrations/mcp.md)
>
> Connect Cleve to Claude, ChatGPT, Claude Code and Codex.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.