Desktop app
Perch Terminal Desktop for macOS, Windows and Linux. Installing it, keeping it updated, and what it does that the browser cannot.
Perch Terminal Desktop is the full agent. It works from the folders on your computer: it reads and edits files, runs commands in a terminal, drives a browser, and spawns helpers. Web chat answers questions and searches; the desktop app does the work.
One account
Installing
Download from the Desktop page. Builds exist for Mac on Apple silicon and Intel, Windows x64, and Linux x64 (in beta).
- Mac. Open the DMG, drag Perch Terminal to Applications, and open it from there. The app is signed and notarized. Running it from the DMG works, but it cannot update itself there, so move it to Applications.
- Windows. Run the installer and launch from Start. If SmartScreen warns, choose More info, then Run anyway: the Windows build is not EV-signed during early access.
- Linux. On Ubuntu or Debian install the
.deb, which also installs the security profile Ubuntu needs for Perch's sandbox. On other distributions use the AppImage:chmod +xit, then run it. AppImages need FUSE 2 (libfuse2, orlibfuse2t64on Ubuntu 24.04 and later).
First run
- Sign in with Google or GitHub.
- Approve a folder. Perch only reads and writes inside folders you approve. Start with the folder that holds the work.
- Ask it to read first. The first useful answer usually comes after Perch has inspected the files, not before.
A folder you approve stays approved, and the chat list groups your chats under the folders they belong to.
Updates
The app keeps itself up to date. It checks for a new version shortly after the window opens and then every few hours, downloads it in the background, and shows Restart to update when it is ready. Choosing that installs it and starts Perch again. If you never choose it, the update installs when you quit.
To check by hand, choose Check for Updates… from the Perch Terminal menu on a Mac, or from Help on Windows and Linux.
Two platform details:
- On a Mac, the app cannot replace itself while it runs from the DMG. Move it to Applications, or choose Move to Applications when Perch offers it.
- On a Linux
.debinstall, the update needs your password, because the package is installed with the system package manager. That one installs only on Restart to update, never on quit.
What the desktop app adds
| Only here | What it is |
|---|---|
| Local folders and files | Reading, writing, moving and editing files in folders you approve. |
| A terminal | Running commands, including in the background. |
| The agent browser | A real browser in a side panel that Perch drives, using sessions you are signed into. |
| Slash commands | Goals, deep research, /verify, and the rest. See Slash commands. |
| Sub-agents and Flock | Helpers inside a turn, and a planned team for a hard task. |
| MCP connectors on your computer | Tools that run as a program on this machine. |
| Local models | Running Perch on a model served from your own computer. |
The side panels
The right-hand side of the window holds three panels, one at a time:
- Browser. The agent browser, with an address bar and back, forward and reload, so you can take the wheel at any point. It can also pop out into its own window.
- Files. The files from this chat, and a viewer for one of them.
- Terminal. What Perch ran, and its output.
The composer's Context window panel shows what the current turn was built from, including the memory notes it was given. See Memory and Context.
On Pro and Ultra the app also has a CLI agents tab, where Claude Code and Codex run on your own plans, each in its own copy of your repository.
Perch Terminal in a browser
On Pro and Ultra, Perch Terminal also opens in a browser at chat.perchai.app/agents/desktop. It is the same surface, running in the cloud rather than on your machine, so it has a workspace of its own instead of your local folders.
Remote control
Send messages from the web or your phone and have them run on your own computer, with its folders and tools. Nothing is moved to the cloud. In beta for Pro.
Perch on your phone
Add Perch to your phone's Home Screen, no app store needed. Chat on any plan. With Pro, in beta, start cloud agents, reach your computer from anywhere, and get a notification when a run needs you.
