---
title: "Index 01"
canonical_url: https://developer.repebble.com/index-01/
last_updated: 2026-11-07
sdk_version: 4.44
---
# Index 01

Source: https://developer.repebble.com/index-01/

Index 01 is a small ring with a button and a microphone, sold at [repebble.com/index](https://repebble.com/index). Press the button, say the thought you want to keep, and the recording is sent to your phone, where it is added to your notes, set as a reminder, or kept in the Index feed for later. The ring records only while the button is pressed. Speech recognition and the assistant can run on the phone with no internet connection, or in the cloud.

The ring sends each recording to the Pebble mobile app over Bluetooth, and the app transcribes it, acts on it, and keeps it in the Index feed. Developers can receive each recording at their own HTTP endpoint with a [webhook](https://developer.repebble.com/index-01/webhooks.md), give the assistant new tools by connecting an [MCP server](https://developer.repebble.com/index-01/mcp.md), or write a [plugin](https://developer.repebble.com/guides/plugins.md) that the assistant can use.

## How the Ring and the App Split the Work

The ring firmware is a small fixed loop: it detects button presses, records audio while the button is held, holds recordings until the phone collects them, and transfers them over Bluetooth. It does not transcribe or interpret anything. All of the logic lives in the Pebble mobile app, which is open source at [github.com/coredevices/mobileapp](https://github.com/coredevices/mobileapp). The ring code is in the `experimental` module of that repository. This section documents the app side only; there is no ring firmware SDK.

## Gestures

The button recognises five gestures. Each one is routed from the _Ring Button_ screen in the Index 01 settings of the Pebble mobile app. The three music gestures can be configured on Android only; on iOS they are shown disabled.

| Gesture | Options |
| --- | --- |
| Click, Double click, Triple click | Play/Pause, Next track, or Nothing |
| Hold & Talk | Index agent, Web search, MCP sandbox, Webhook only, or Nothing |
| Double click & hold | Index agent, Web search, MCP sandbox, Webhook only, or Nothing |

The two hold gestures record a voice note. _Index agent_ transcribes the note and takes actions such as creating a note, a reminder, a timer, or a calendar event. _Web search_ answers a question and puts the answer in the feed. _MCP sandbox_ runs the recording through a sandbox group of MCP servers that you choose. _Webhook only_ sends the recording to your endpoint and does nothing else. A recording gesture routed to _Index agent_, _Web search_ or _MCP sandbox_ can also send a copy to its webhook with the _Also send to webhook_ switch; the switch is not shown for _Webhook only_ or _Nothing_.

## Local and Cloud Processing

Speech recognition and the assistant model are each set to run in the cloud or on the phone in the Index 01 settings. Webhooks do not depend on either setting: the audio is sent as recorded, and the transcript is whatever the selected speech recognition produced. Remote MCP servers are only called by the cloud model.

## Building on Index 01

There are four extension points.

- [Plugins](https://developer.repebble.com/guides/plugins.md) run inside the Pebble mobile app and declare actions and data sources. The assistant will call a plugin's actions as tools, and a plugin that declares `create_note` or `create_reminder` can be offered as a destination for notes and reminders. Plugins are a preview and are off by default.
- [Webhooks](https://developer.repebble.com/index-01/webhooks.md) send each recording as a multipart HTTP POST to a URL you configure, with the audio, the transcript, or both, and an optional HMAC-SHA256 signature. Use this to feed recordings into your own service, an automation tool, or a note-taking app. You run the endpoint.
- [MCP servers](https://developer.repebble.com/index-01/mcp.md) add tools to the assistant. The app connects to any MCP server over HTTP, lists its tools, and lets the Cloud LLM call them when it processes a recording. You run the server.
- Button advertising packets. The ring broadcasts a BLE advertising packet each time the button is pressed or released, even while it is connected to the phone. Any nearby computer can read them with no pairing or connection, and use the ring as a remote button, for example to advance slides. [index01-detector](https://github.com/ericmigi/index01-detector) is a Mac menu bar app that does this, turning the button into a push-to-talk key for Wispr Flow or any other app with a hold-to-dictate hotkey.

## Where the Code Lives

Everything in this section is implemented in the Pebble mobile app at [github.com/coredevices/mobileapp](https://github.com/coredevices/mobileapp):

- Webhook request format and signing: [`external/indexwebhook/`](https://github.com/coredevices/mobileapp/tree/main/experimental/src/commonMain/kotlin/coredevices/ring/external/indexwebhook/)
- Gesture routing: [`service/button/`](https://github.com/coredevices/mobileapp/tree/main/experimental/src/commonMain/kotlin/coredevices/ring/service/button/)
- MCP settings screens: [`settings/mcp/`](https://github.com/coredevices/mobileapp/tree/main/experimental/src/commonMain/kotlin/coredevices/ring/ui/screens/settings/mcp/)
- MCP client: [`mcp/client/`](https://github.com/coredevices/mobileapp/tree/main/mcp/src/commonMain/kotlin/coredevices/mcp/client/)
