Chat with your own AI plan
In the Atlas desktop app, a folder on your computer can be a project. Its chat can run your own Claude, ChatGPT, or Gemini plan, which reads the notes and PDFs in the folder and answers with citations to them. Your plan pays for these answers, and Atlas does not upload the folder.
This works only in the desktop app for Mac and Windows. See Install the desktop app.
Open a folder as a project
- In the desktop app, open the projects gallery.
- Select New project, then Open folder… for an existing folder, or Create folder… for a new one.
The left panel shows the folder's subfolders, .md notes, and .pdf files. Other files and hidden files do not show. Notes you edit in Atlas save back to their .md files.
In the projects switcher, folder projects are under On this computer and account projects are under Online.
Choose an AI
The first time you chat in a folder, the chat panel shows Choose an AI for this folder:
| Choice | What it uses | Reads the folder |
|---|---|---|
| Gemini | Google's Antigravity CLI. Free with a Google account. | Yes |
| Claude | Claude Code with your Claude plan. | Yes |
| ChatGPT | Codex with your paid ChatGPT plan. | Yes |
| Atlas | The Atlas chat model. | No |
Each choice shows its state on this computer, such as Signed in, Not installed, or Update needed. Finish the setup step it shows, then select Use and the AI's name. Atlas remembers the choice on this computer.
To change the AI later, use the AI picker in the composer. Switching AI starts a new chat.
Set up each AI
- Claude: Atlas runs the Claude Code program on your computer. If it is missing, select Install Claude Code. If it is too old, select Update Claude Code. If you are signed out, select Sign in and finish Claude's sign-in in your browser.
- ChatGPT: select Continue with ChatGPT and finish signing in in your browser. Atlas then sets up ChatGPT once. ChatGPT Free cannot be used.
- Gemini: if the Antigravity CLI is missing, select Install Antigravity CLI. If Google asks you to sign in on your first message, select Sign in with Google.
Installs and sign-ins run in a terminal inside the chat panel. The chat comes back when they finish.
Ask about your files
Type your question in Ask about this folder and send it. The answer shows the steps the AI took, such as reading a PDF or searching notes, and cites the files it used.
- Select a PDF page citation to open the PDF at that page.
- Select a note citation to open the note.
- Select Stop to end an answer. You keep what arrived.
Chats are saved on this computer and listed under Chats in the left panel. Follow-up messages continue the same conversation.
What the AI can do in the folder
- Read, search, create, and edit notes and files inside the folder.
- Rename the project, which renames the folder.
- Delete notes or folders by moving them to the Trash, where you can restore them.
- List and delete this project's chats.
The AI cannot change files outside the folder and cannot use the web. What it reads goes to Anthropic, OpenAI, or Google under your own plan or account.
Fix setup and usage problems
| Message | What to do |
|---|---|
| A plan limit with a reset time | Wait until the reset time, or choose another AI in the composer's picker. |
| Usage limit reached. (ChatGPT) | Select Manage usage to check your ChatGPT plan. |
| You've reached your Gemini usage limit. Please try again later. | Try again later, or choose another AI. |
| A ChatGPT plan that can't be used in other apps | Upgrade from ChatGPT Free in ChatGPT, then select Continue with ChatGPT again. |
| Any other failure | Select Open Claude Code in terminal or Open Antigravity CLI in terminal to see the program's own message. |