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

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.

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.

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

Where your Pebbles run

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.

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 a free ChatGPT account, or the AI plan you already have (ChatGPT or Grok). 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

Pebble is an independent app.

← pebble.bot