Quickstart
Get started with Perch on the web, on the desktop, from the command line, or on your phone.
Perch runs in the browser, on your computer, in your terminal, and on your phone, all on one account. Pick the one that matches how you want to work. You can move between them later without losing your memory or your usage allowance.
One account, one allowance
Start on the web
The web chat is the fastest way to try Perch. There is nothing to install.
- Go to chat.perchai.app. You can type your first message before you sign in; sending it opens sign-in with Google or GitHub. No invite code and no waitlist.
- Upload a document, or just ask a question. A new account starts on Starter, which is free, with your first message. See plans opens the plan picker if you want a different one.
- Read the answer and check the sources attached to it.
On the web you can upload documents, ask for answers with sources, turn on web search, and check a draft against the sources you added to the chat. Local folders, the terminal, and the agent browser stay on the desktop app and the CLI.
Use the desktop app
The desktop app is the full Perch operator. It works directly from the folders on your computer.
- Download the desktop app from the Desktop page and install it. The Mac app is signed and notarized; on Windows, follow the install notes if SmartScreen warns. On Linux (x64, in beta), install the .deb on Ubuntu or Debian, or run the AppImage on other distributions.
- Sign in. Your web account and your desktop account are the same account. A new account picks Starter, Pro or Ultra on first sign-in.
- Approve a folder. Start with the folder that already holds the work: cases, invoices, statements, exports, drafts, or research.
- Ask Perch to read first. The first useful answer usually comes after Perch has inspected the files, not before.
The app keeps itself up to date. See Desktop app for installing, updating, and what each platform needs.
Use the CLI
The CLI gives you the same operator from your terminal.
npm install -g perchai-cli # Node 22 or newer
perch login # sign in with Google or GitHub
perch # start working in the current folderSign in once, open a terminal in the folder that holds the work, and run perch. The CLI and the desktop app share the same engine and the same account. The CLI reference lists every command.
Put Perch on your phone
Open chat.perchai.app on your phone and add it to your Home Screen. It opens like an app, with no app store needed. Perch on your phone has the steps for iPhone and Android.
Choosing Quill or Saffron
In Perch Terminal and the CLI, Perch has two voices that share one workspace, one memory, and the same tools. Either one will fix a bug, research a question, review a folder, or draft a memo:
- Quill is warm and literate, more present on the page.
- Saffron is direct and dry, leading with the finding.
Pick the one you would rather read. See Personas for how to switch.
Next steps
- Understand the engine: How Perch works.
- Learn the commands: Slash commands.
- Use Perch in your language: Languages.
- Manage your sign-in and account: Your account.
- Keep a task running after you close the laptop: Cloud agents, in beta for Pro and Ultra.
What is Perch
Perch is an AI agent you can hand real work to. It runs in your browser, on your computer, in your terminal, in the cloud, and on your phone, all on one account.
Starter plan
What free Starter includes, how hosted and bring-your-own-key usage differ, and how the Starter Data Program works.