Skip to Content

⌚ Pebble

Recall and search your Companion Memory from your wrist. The watch asks your phone, your phone asks your Companion Memory, and the answer comes back with a short buzz.

Open the live site pebble.ci.computer

The site previews the setup steps and the roadmap. The app is now on the Rebble App Store .

Get a Companion Core, a personal AI appliance and local server, or download Companion Hub to turn a computer you already own into one.Buy Companion Core →Download Companion →Back to ci.computer

Overview

Companion Memory for Pebble is a Pebble watchapp with a phone companion. It is not a Companion Hub app, and it doesn’t use Rebble or the Pebble app as anything other than the way your watch talks to your phone. The watch never touches the network. It sends a small request over Bluetooth to the companion running in the Pebble phone app, and the companion makes one authenticated HTTPS call to the Companion Memory address you enter.

Status: available on the Rebble App Store. Install Companion Memory for Pebble from the Rebble App Store  in the Pebble phone app. It is version 1.0, and it has not yet been tested on a physical watch, so expect rough edges and tell us what you find on the Discord . The source is public at companionintelligence/CI-Pebble .

The app reads from your Companion Memory. It doesn’t receive Hub alerts, run Hub automations, control Omi, or push items into the Pebble timeline. Those ideas are on the roadmap, not in the app.

Key features

  • Recall — the latest from your Companion Memory in one press.
  • Ask — pick a question from a list, or speak your own on watches with a microphone. Companion Memory searches what you saved and returns the lines that match. The answer is a search result, not a generated reply.
  • Last answer — your most recent answer stays on the watch, so it is there offline.
  • Connection check — after you save settings, the phone companion tells you what works: Recall and Ask, watch registration, and location sync.
  • Location sync — optional and off by default. When you turn it on, the phone sends one location sample to your Companion Memory every 15 minutes.

An answer buzzes the watch and appears as short lines, fitted to 252 characters. Errors state a fact and a fix, for example “Key rejected. Paste it again in settings.”

Supported hardware

The watchapp targets all five Pebble platforms.

PlatformWatchesSpeak (dictation)
AplitePebble Classic and SteelNo microphone. Pick a listed question.
BasaltPebble Time and Time SteelYes
ChalkPebble Time RoundYes
DioritePebble 2Yes
EmeryPebble Time 2Yes

You also need the Pebble phone app for your watch. If you use Rebble for your watch’s services, follow the Rebble setup guide  first.

Technical architecture

The Pebble client is open source on GitHub at companionintelligence/CI-Pebble . It acts as a lightweight wrist client for Companion Memory, using the PebbleKit JS companion bridge to relay requests over Bluetooth to your home appliance.

Architecture highlights

  1. Watch C application: Built using the Pebble SDK in C. Manages text scroll windows, action bars, and memory consumption to fit within microcontroller memory constraints (under 64 KB RAM) and a 252-character display budget.
  2. Phone companion (PebbleKit JS): Runs inside the Pebble or Rebble mobile app on iOS or Android. Translates Bluetooth AppMessage dictionary packets into HTTPS calls to Companion Memory (POST /api/memory/recall), strips Markdown formatting, and truncates results into displayable byte blocks.
  3. Key-scoped authorization: Uses scoped Companion Memory API keys (x-api-key) with memory recall permissions, while optional device registration and 15-minute background location sync use an unrestricted key.

Setup

You need a running Companion Memory that your phone can reach over HTTPS. On iOS, an http:// address is refused.

Create a Companion Memory API key

In Companion Memory, open Settings → API Keys and create a key with the memory scope. See Get your API keys. To check the key from a terminal:

curl -X POST https://your-memory.example/api/memory/recall \ -H "x-api-key: YOUR_KEY" -H "Content-Type: application/json" \ -d '{"query": "what happened recently?", "maxResults": 3}'

Build the watchapp

In CloudPebble , import the watchapp’s source repository (you need access to it) and select Compile. To build locally instead, install the Pebble SDK and build from the source folder:

uv tool install pebble-tool pebble sdk install latest npm run build

Install it on your watch

Send the build to your watch from CloudPebble. To try it in the emulator first, run pebble install --emulator basalt.

Connect your Companion Memory

In the Pebble phone app, open the settings for Companion Memory and, under Connect your Memory, enter your Memory URL and API key. Save. The companion checks the connection and lists what works. Without a saved URL, it tries a default local address that most setups don’t have, so always enter your own.

What each feature needs from the key

Companion Memory denies a scope-limited key on any route that doesn’t name its scope. That decides what a key can do today:

FeatureKey it needs
Recall, AskScope memory
Register this watch as a deviceUnrestricted key
Location syncUnrestricted key

With a memory-scoped key, Recall and Ask work, and the settings page reports that registration and location sync need an unrestricted key.

Usage

The main menu has three rows: Recall (“Latest from Memory”), Ask (“Search your Memory”), and Last answer (“Saved on this watch”). Select a row with the buttons.

Three Pebble Time emulator screens side by side: the Companion Memory main menu with Recall, Ask, and Last answer rows; the Ask list with Speak, My goals, Last week, and Coming up; and an answer showing three memory lines followed by +2 more
The main menu, the Ask list, and an answer on Pebble Time, from the Pebble emulator. The answer text is sample data.
  • Recall — asks your Companion Memory to summarize what happened recently and anything you should know about right now, then shows the answer.
  • Ask — opens a list of questions: My goals, Last week, Coming up, and Recent activity. On watches with a microphone, a Speak row (“Use dictation”) lets you ask your own question.
  • Last answer — shows the most recent answer again without asking your phone. If you haven’t asked anything yet, the watch says “Nothing saved yet. Run Recall first.”

Speaking a question uses Pebble Dictation, which is a cloud speech service. The audio goes to the speech service your Pebble platform uses, not to this app and not to your Companion Memory. Picking a listed question sends no audio anywhere.

Privacy

  • Requests go from your phone straight to the Memory URL you enter. There is no relay, no account, and no analytics.
  • The API key stays on your phone.
  • Location sync is off until you turn it on, and it only ever goes to your Companion Memory.

Troubleshooting

You seeDo this
”Key rejected. Paste it again in settings.”The key is missing, mistyped, or revoked. Create a new one and paste it whole.
”Key can’t do that. Give it the memory scope.”Recreate the key with the memory scope.
”Can’t reach your Memory.”Check the Memory URL. On iOS it must be HTTPS.
”Nothing found. Try a broader question.”Your Companion Memory had no match. This isn’t an error.
Settings say registration or location “needs an unrestricted key”Expected with a memory-scoped key. Recall and Ask still work.
No Speak rowYour watch has no microphone (Pebble Classic and Steel). Pick a listed question.
The watch says “Phone unreachable”Open the Pebble phone app and check the Bluetooth link.

Roadmap

The repository’s roadmap plans a recorder (speak a note and save it to Companion Memory), a planner (today’s tasks and adding tasks by voice), and reminders on the wrist. None of these are in v1.0.

Last updated on