Pebble Help Center
Pebble gives your business a team of AI agents: Pebble Bots (Pebbles), each with its own job. They draft the work, and you approve what goes out. These pages cover the basics. If something here does not match what you see, write to support@pebble.bot.
- Get started in 5 minutes
- If sign-in doesn’t finish
- Where your Pebbles run
- Pebbles and chats
- Workspaces
- Settings
- Updates
- Feedback
- Questions
- Contact and account
- Privacy and Terms
Get started in 5 minutes
1. Download
Get the desktop app for Mac (Apple silicon), Windows or Linux from pebble.bot/download. On Windows you can also get it from the Microsoft Store. Mobile apps: coming soon. Pebble is free for personal use; for work, see License for work.
2. Open Pebble
The first screen says Welcome to Pebble and the three steps ahead: sign in, choose where your Pebbles run, then connect the AI you already use.
3. Sign in
Choose Continue with email, Continue with Google or Continue with Apple.
- Email. Type your email address and choose Continue. Enter the six-digit code we email you. It can take up to a minute; check your spam folder too.
- Google or Apple. Pebble opens the sign-in page in your web browser. Finish there, then come back to Pebble. Stuck? See If sign-in doesn’t finish.
Use the same Pebble account on each of your computers and on the web.
4. Choose where your Pebbles run
Pebble asks: Where should your Pebbles run? You can add others later.
- Pebble Cloud (Recommended): always on, even with your computer off. We run the server for you. Choose Set up, pick a plan and a region, and choose Buy. How Pebble Cloud works.
- On this computer: installs and runs Pebble Server, the engine for your Pebbles, on this Mac, Windows PC or Linux computer. Choose Set up, then Install. Pebble shows the space it needs and about how long it takes (about 3 minutes on a fast connection). While it works, the line over the progress bar says which step it is on, such as Downloading Pebble Server, Installing Pebble Server or Starting Pebble Server, then Pebble Server is ready. If you quit, setup picks up where it stopped.
- Your own server: for a server you already run. Choose Connect.
5. Connect the AI you already use
If no AI is connected yet, Pebble asks: How should your Pebbles think? Choose ChatGPT subscription to sign in with your ChatGPT account (a free ChatGPT account works), or Grok subscription for a Grok plan you already have. API key lets you paste a key from your AI provider. You can connect one or several. Not ready yet? Choose later closes this step; you can connect one at any time in Workspace settings › AI providers.
6. Meet your first Pebble
Pebble shows Meet your first Pebble. Choose Chat, type what you need in the box and press Enter. On a Mac, Pebble keeps working in the background so your Pebbles can finish tasks with the window closed; macOS shows a notice about it.
If sign-in doesn’t finish
- Google or Apple. While Pebble says Waiting for your browser…, finish signing in on the page that opened. Closed it by mistake? Choose Open the sign-in page again. If Pebble says Sign-in didn’t finish, choose Try again, or Use email instead to sign in with a code.
- Email code. No email after a minute? Check your spam folder, then choose Send a new code. If Pebble says That code didn’t work or That code expired, send a new one and type the newest code.
- Still stuck? Write to support@pebble.bot with your Pebble version and what the screen says.
Where your Pebbles run
- Pebble Cloud. Pebble Cloud is a private, always-on server we run for you; every paid plan from Essential up includes the commercial license. Choose it, pick a plan and a region, and choose Buy. Checkout opens in your web browser; after you pay, your server is set up (about 20 minutes) and appears in the app as a new workspace when it is ready. The app shows each plan’s price before you buy (USD per month, plus tax). Cancel anytime. If the app says New orders are paused for now, start On this computer and add Pebble Cloud later. See the Pebble Cloud Terms.
- On this computer. On Mac, Windows and Linux, Pebble installs Pebble Server, the engine your Pebbles run on, and starts it for you. If Pebble says Pebble Server isn’t running on this computer, choose Start Pebble Server. On a Mac that lacks Apple’s developer tools, macOS first asks to install them: choose Install, then Agree, and setup goes on by itself. If setup stops, choose Try again or Choose another way. To keep your Pebbles working while the app is closed, turn on Keep my Pebbles running when the app is closed in Settings › General.
- Your own server. For a server you already run, on another computer or a rented one. It must be online. Choose Connect, type its web address (it must start with https) and sign in there.
Pebbles and chats
Each Pebble has its own job and can use its own model. To make one, choose New Pebble, type a name and choose Create Pebble. You land in its chat with a few things to try. Marketplace has ready-made Pebbles you can add.
Group your Pebbles into Teams, for example one for each part of your business. Pick a Team when you make a Pebble (Team is optional; New team… makes one), or later in Pebble settings › Appearance & organization › Team. Moving a Pebble changes only where it is filed; its chats and settings go with it. Teams in the title bar shows the open Pebble’s Team.
In a chat, type in the box under the conversation and press Enter or choose Send. The + beside the box attaches files, folders and links. Choose Stop while a Pebble is answering to stop that reply. Longer work can run in the background while you keep chatting. If you write while a Pebble is busy, your message goes into what it is doing now, and it answers you first. To make messages wait their turn instead, turn on Queue messages while a Pebble is busy in Workspace settings › Chat. A message on its way says Sending…. If it hasn’t reached your Pebble yet, it says Not delivered yet: Pebble keeps trying, and Send now tries again at once. Choose Pebble settings in its chat header to change its name, model and how it behaves.
When the box is empty, Pebble can show a suggested message for the chat you have open, a guess at what you might write next; press Tab to use it, and Enter never sends it by itself. Each suggestion stays in its own chat. Turn Suggested messages on or off in Settings › General; they use some of your AI allowance.
Workspaces
A workspace is one place your Pebbles run: Pebble Cloud (we run the server for you), your own server, or this computer. Choose Add workspace (the + in the left rail) to add one; it shows the same choices as the first run. Switch between them in the left rail, or press ⌘1 to ⌘9 on Mac (Ctrl+1 to Ctrl+9 on Windows and Linux). Each workspace keeps its own Pebbles and sign-in, so nothing is mixed. Workspace settings, at the bottom of the rail, hold the settings for the workspace you have open, saved with that workspace so every computer shows the same: General (its name and colour theme), Chat (Queue messages while a Pebble is busy and Revive automatically), AI providers, Teams, Server and Plan & billing. A page that doesn’t apply to that workspace isn’t shown.
Settings overview
App settings apply to everything on this computer. Open them from your account picture’s menu. Sections: General, Account, Workspaces (every workspace on this computer and your Pebble Cloud plans), Appearance, Notifications, Voice, Keyboard, Updates, Privacy, Advanced, Support and About. Settings for one workspace, such as its colour theme and how a busy Pebble takes your messages, are in Workspace settings.
- General has Startup, Let Pebbles use this computer, and Chat & composer (including Suggested messages).
- Let Pebbles use this computer (in General) has one switch, Allow computer access, for every Pebble in every workspace at once. Pebbles can then see apps, click and type; they ask before they send, buy or delete, and you can stop them at any time. On a Mac, also allow Accessibility and Screen Recording with Open System Settings. To turn it off for one workspace, use Let Pebbles here use this computer in that workspace’s Workspace settings › General. A workspace other people use asks you once first. Pebbles on a server can use this computer only while Pebble is open on it.
- Account shows who you are signed in as, Usage (your account’s total across all your workspaces) and Devices (the Pebble apps signed in to your account). Under them: Sign out everywhere… and Delete account….
- Support has Get help, Help Center, Send Feedback and Save problem report.
- Pebble settings apply to one Pebble and open from Pebble settings in its chat header: Identity, Appearance & organization (including its Team), Model, Access & approvals (its approval mode) and Advanced (How this Pebble works is at the top).
Changes save as you make them.
Updates
Open Settings, then Updates. It shows your Pebble version. Choose Check for updates; checking never installs anything by itself. When a new Pebble is ready the button becomes Download, then Restart to update. With the Linux .deb, confirm the update when Software asks. If you got Pebble from the Microsoft Store, the Store updates it for you. Your server’s software, Pebble Server, updates from Workspace settings › Server: choose Update when Pebble Server update ready shows; Pebble backs your Pebbles up first, shows Updating Pebble Server… while it works, and Restore backup brings that backup back. Pebble shows Pebble Server while it sets up, starts or updates your server. What changed in each version: What’s new.
Feedback
In the app, open Settings, then Support, and choose Send Feedback. Or write to support@pebble.bot with your Pebble version and a short description of what you see. Save problem report, in the same section, makes one file you can attach to your message. It leaves out secrets and emails.
Questions
Which computers does Pebble run on?
Mac (Apple silicon), Windows 10 and 11 (x64) and Linux (x64 and arm64). iPhone and Android apps are coming soon.
Do I need a new AI subscription?
No. Pebble works with ChatGPT, Grok, Claude and any API provider, including local models. Each provider keeps its own plans, limits and costs.
Is Pebble built on Hermes?
Yes. Pebble Server is built on the open-source Hermes Agent by Nous Research (MIT license). The license and credit are in the app too: Settings › About › Third-party software. Workspace settings › Server shows the engine and its version on its Engine card.
Contact and account
- Support: pebble.bot/support · email support@pebble.bot
- Send feedback: Settings › Support › Send Feedback.
- Problem report: Settings › Support › Save problem report (a file to attach to your email; it leaves out secrets and emails).
- Order Pebble Cloud: on the web at pebble.bot/hosted/order, or in the app, Add workspace, then Pebble Cloud. How it works. Use the same Pebble account on the web and in the apps.
- Cancel Pebble Cloud: on Your Pebble Cloud, or in the app, Settings › Workspaces, then the plan’s ⋯ menu › Cancel at period end, or email support@pebble.bot. Card and invoices: Manage billing on Your Pebble Cloud.
- Sign out on every computer: Settings › Account › Sign out everywhere….
- Delete your account: pebble.bot/account-deletion
- Privacy: Pebble Cloud Privacy Policy · App privacy policy · Terms
- Sales and partnerships: hello@pebble.bot
Privacy and Terms
Pebble is an independent app.
← pebble.bot