The desktop app

Projects, chats per project, the terminal panel and how the app is organised.

The desktop app is Peridot Code: the chat you know, plus an agent that works inside a folder on your computer. It is also where you build an AI team.

Projects#

A project is a folder on your computer.

Click + next to Projects in the sidebar and choose a folder to add it.
Click a project to make it the one you are working in. The agent can only see and change that folder.
Every chat belongs to the project it was started in. Opening an old chat switches back to its project.
The small × next to a project removes it from the list. It never deletes anything from your disk.

The app remembers your projects on this computer, and reopens the last one when it starts.

The window#

The window has no system frame. Its own title bar holds:

Control	What it does
Sidebar toggle	Show or hide the sidebar.
Back / Forward	Move through the chats you opened, like browser history.
Chat title	Click to rename the current chat.
Folder button	Show the project in your file manager.
Terminal button	Open the terminal panel.
Minimise, maximise, close	The usual.

From top to bottom: New (start a fresh chat in the current project), Your AI team, Plugins, links, your projects with their chats, and your account menu (settings, usage, language, plan).

The input#

The input box is where you tell the agent what to do. Around it:

+ attaches text files (up to 500 KB each).
The project chip shows which folder the agent works in.
The approval switch toggles between Manual (ask before every edit or command) and Auto approval. See Tools and approvals.
The model picker chooses the model and effort. See Models and effort.
The microphone dictates your message.

The terminal panel#

Click the terminal button in the title bar to open a real terminal (a shell with a pseudo-terminal) at the bottom of the window, started in your project folder. It is yours: you type, it runs. It is separate from the agent's own commands, which appear as cards in the chat. Switching to another project starts a fresh shell in that folder.

Plugins#

Plugins in the sidebar lists plugins approved on tryperidot.io. Install one with a click; it is installed on your computer and shared with the CLI. See Plugins.

Your AI team#

Your AI team opens a page where you create bots for the current project and watch them work. See the team overview.

Everything in the app uses your Peridot account. Pages of the website (pricing, docs, account settings in the browser) open in your normal browser instead of inside the app.

← Models and effort Tools and approvals →