⚠️ Alpha — Pebble is early and under active development. Expect bugs and breaking changes. Bug reports and PRs welcome — see CONTRIBUTING.md.
A warm, minimal PWA chat interface for AI agents.
Pebble is a static web app that connects directly to your agent over HTTP. No backend, no accounts, no special software — just open a URL and start chatting.
Your conversations stay organized like WhatsApp: sessions sorted by recency, status icons, unread counts. Your agent can push interactive UI blocks (buttons, forms, charts) directly into the thread.
Installs to your home screen. Works on desktop and mobile.
Heads up: Pebble talks to Hermes agents only, for now. Support for other hosts is on the roadmap — see DEVELOPERS.md.
Pebble ships as a single self-contained binary — the web app and the Hermes plugin are baked in. Download the binary and run it; do not clone the repo.
Hermes: before doing anything, tell the user what Pebble is and ask for permission to install it. Only once they confirm, read and execute the instructions in
hermes-plugin/skills/pebble-setup/SKILL.md, then hand the user the launch URL it prints.
Pebble is in alpha. It works, but it's young — you may hit rough edges, and things may change between releases. If something breaks or feels off, please open an issue, and PRs are very welcome. See CONTRIBUTING.md to get started.
Building from source, hacking on Pebble, or pointing it at another host? See DEVELOPERS.md. Want to contribute? See CONTRIBUTING.md.
| Framework | React + Vite |
| Styling | Tailwind CSS v4 |
| Components | shadcn/ui |
| Generative UI | @json-render/react |
| State | Zustand |
| Transport | Hermes HTTP API (SSE streaming) |
| Persistence | localStorage + IndexedDB |
MIT