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

# Corvic Desktop

> Use Corvic on your Mac: ask about local spreadsheets and documents without uploading them, preview files, and let Corvic edit workbooks in place.

**Corvic for Mac** brings the full Corvic app to your desktop and adds one thing the browser can't: it works with folders on your Mac. Corvic reads your spreadsheets and documents where they are, so only what a query returns reaches the agent, and it can edit a workbook in place with changes you can undo.

## Requirements

* A Mac with Apple silicon, running macOS 13 or later.
* An internet connection. The app runs the hosted Corvic app, so it needs to reach `app.corvic.ai`.

## Install and sign in

**1. Install**

Open the downloaded `.dmg` and drag **Corvic** to Applications.

**2. Sign in in your browser**

The first time you open the app, it sends you to your default browser. Sign in as you do on the web, and the session returns to the app. Links to other sites also open in your browser.

**3. Stay up to date**

Corvic checks for updates shortly after launch and every few hours, installs them in the background, and offers to restart. Choose **Check for Updates…** in the app menu to check now.

## Work with folders on your Mac

In a chat, choose **+ Add Folder from this Mac**. The folder belongs to that chat only. Its files are read on your Mac, not uploaded.

Each folder has a mode:

| Mode | What happens |
| - | - |
| **Ask first** | Corvic asks before reading, changing, or uploading a file. **Allow** covers the folder in that chat until you quit the app; **Always allow** switches the folder to Auto-allow. Changing an existing file always asks. |
| **Auto-allow** | Corvic reads files in the folder without asking. |

If you don't answer a prompt within two minutes, Corvic takes it as a no. Choose **Detach** to remove a folder from the chat.

## Ask about local data

Corvic can query Excel, CSV, TSV, Parquet, and JSON files in place with read-only SQL, and search and read Word, PowerPoint, PDF, and text files. Only the rows a query returns reach the agent.

| Limit | Value |
| - | - |
| Data files per chat | 500 |
| Workbook size | 200 MB |
| Rows returned per query | 500 |
| Query time | 60 seconds |

## Preview files

Select a file to preview it: sheets, tables, PDFs, and images, up to 50 MB. Nothing is uploaded. From a preview you can **Open in its app**, **Show in Finder**, or **Ask Corvic**, and add selected text or cells to the chat. Text in images is recognized on your Mac, so you can select it and ask about it.

## Edit workbooks in place

Corvic can change `.xlsx` and `.xlsm` workbooks directly: edit cells, add or rename sheets, or create a new workbook. Formulas are recalculated and saved with the file. You can type into cells yourself, too.

Every edit keeps the original. Choose **Undo** on the edit's summary to put the file back as it was. Undo is available for 30 days, as long as the file hasn't changed since. Corvic won't edit a file another app has open.

## Related Documentation

> [card] [Corvic Cloud](https://docs.corvic.ai/platform/cloud.md)
>
> The same platform in your browser, with nothing to install.

> [card] [Rooms](https://docs.corvic.ai/features/rooms.md)
>
> Where chats, data, and agents live.

> [card] [Corvic models](https://docs.corvic.ai/models/corvic-models.md)
>
> The models behind each answer.


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