Skip to content
ClairGet Clair
← Set up Clair

Clair on your Wear OS watch

Clair's watch app puts Claude Code's prompts on your wrist and keeps your sessions a glance away. It works together with Clair on your phone, which stays in touch with your computers and passes each prompt on to the watch.

What you need

  • A watch running Wear OS 4 or later, paired with your Android phone.
  • Clair on both. The watch app is a companion: prompts reach it through Clair on your phone, so the phone needs to be paired with your computer first.

Permission prompts

A permission prompt names the tool and shows exactly what it wants to do, such as the command it would run or the file it would edit. Then pick an answer:

  • Allow lets it run this once.
  • Allow for session lets it run for the rest of the session.
  • Allow & remember accepts the rule Claude Code suggests, like every go test run, so it stops asking.
  • Deny asks why. Dictate or type a reason and Claude reads it, or send the denial without one.
The watch's answers for a Bash prompt: Allow, Allow and remember for go test commands, and Deny with a reason.

Questions

When Claude asks you to choose, each option arrives with its description. Scroll with the crown and pick one, or several when Claude allows it. Other lets you type or dictate an answer of your own. A question with several parts goes one step at a time.

A question from Claude on the watch, offering an idempotency table or a Redis lock, each with a short description.

Plan reviews

A long plan opens on a digest: its opening lines, then a button for each section. Tap a section to read from its heading, or Read full plan for all of it. Every word in the digest is the plan's own, since Clair doesn't summarize it, and a plan that takes a minute or less to read opens whole.

Then answer with the choices the terminal gives you:

  • Yes, and use auto mode
  • Yes, auto-accept edits
  • Yes, manually approve edits
  • No, keep planning, with a note on what should change
A plan review on a Wear OS watch: Approve plan? above the choices "Yes, and use auto mode" and "Yes, auto-accept edits", with "Yes, manually approve edits" below them.

The tile

Add the Clair tile and a swipe from the watch face shows what needs you. It changes with what's going on:

  • One prompt waiting: that prompt, a tap from answering it.
  • Several waiting: a row for each. Answer one and the next one opens.
  • Claude working: what it's doing now, such as Reading, Editing or Testing, over a strip of its latest tool calls.
  • Turn finished: how it went, such as Tests passed · 4 files, Build failed or Committed.
  • More than one session running: a row for each session.
The Clair tile: a waiting Bash prompt in the payments-api session, two more sessions, and a Respond button.

Tile detail, in the watch's settings, sets how much the tile and complication say. Detailed shows commands, files and questions. Normal shows projects and activity without the arguments. Private shows counts and states only.

The complication

Put Clair on a watch face and it counts the sessions waiting for you. With nothing waiting, it shows how many sessions are working, idle or ended instead, and Off when the watch can't reach your phone. Its ring is your token usage in the current five-hour window. Faces with room for the long version also show the seven-day window.

Clair's complication on a round watch face: an attention mark over the number 2, for two sessions waiting on you, inside a usage ring that runs from green to amber. Labels name the session state, the count waiting on you, the five-hour usage ring, and tap to answer. Below, the icon for each state: waiting on you, working, idle, ended, and Off for a phone out of reach.

On faces that color the ring, it runs from green to red as the window fills, and it empties when the window resets. A tap opens the oldest prompt waiting for you. With none waiting, it opens the session it's counting, or your session list when the count covers more than one.

Where the usage comes from

The Clair watch face

On Wear OS 6 or later, Clair comes with a watch face of its own, Clair Chrono. It's a chronograph whose three small dials track your Claude Code limits: your five-hour window and your weekly window, each with the time left until it resets, and how full your current session's context window is, with its project named underneath. The window under 12 shows what your sessions are doing and how many need an answer. Tap it to open the oldest prompt waiting.

The Clair watch face, a chronograph. A window under 12 shows an attention mark and 2, for two sessions waiting on you. Three small dials read five-hour usage at 68% with 2h 14m until it resets, weekly usage at 41% with 3d 6h, and context at 23% for a project named payments, each with a red arc over its last 20%. Below, the face in its analog, digital and always-on styles.

On each dial, the red arc marks the last 20%. Edit the face to tell the time with hands or digits.

Clair installs the face along with the watch app. To switch to it, tap Clair Chrono in Clair's settings on the watch. The app can make that switch for you once, so after that, touch and hold your watch face and choose Clair Chrono. If you removed the face, the same row adds it back.

The three dials are complications in their own right: Clair 5-hour usage, Clair weekly usage and Clair context window. Put them on any face with a slot for them, which is how you get them on Wear OS 4 and 5.

Live Updates on Wear OS 7

On Wear OS 7, Clair follows a Claude Code turn with a Live Update: Starting, then Working, then Done. When Claude Code is waiting on you, it reads Needs you, with the prompt's headline. A finished turn stays at Done for a minute.

With several sessions under way, the Live Update shows a chip for each one, such as "api · Testing" or "docs · Needs you", under a strip colored by which sessions are working, idle or waiting on you. Sessions waiting on you come first. Tap a chip to open that session, or the prompt it's waiting on.

Before Wear OS 7, Clair shows your sessions as an ongoing activity instead, without the stages or the chips.

Away from your phone

Leave the phone at home and take the watch for a run. If the watch has its own Wi-Fi or LTE connection, prompts keep reaching it over the internet once the phone is out of Bluetooth range, and your answers go back the same way. The phone still does the work from wherever you left it, so it has to stay on and online.

The Phone card in the watch's settings says which it is: Connected nearby, Connected over the internet, or Disconnected. Disconnected means the watch can't reach the phone at all.

Between the phone and the watch, prompts travel over Wear OS's own connection, which runs through Google's servers when the two aren't within Bluetooth range. Clair's end-to-end encryption covers the path from your computer to your phone.

Watch settings

SettingWhat it does
Notify: permissions, questions, plansTurns notifications on or off for each kind of prompt.
Vibrate on new requestBuzzes when a prompt arrives.
Tile detailHow much the tile and complication say: Detailed, Normal or Private.
Clair ChronoSwitches to the Clair watch face, adds it back if you removed it, or says how to choose it. Wear OS 6 or later.
Send crash & usage dataSends crash reports and usage statistics to Google Firebase. Turn it off to stop both. The phone has its own switch.
SubscriptionWhether the watch can answer prompts. You subscribe on the phone. Without a subscription, the watch still shows sessions, the tile, the complication and notifications, and prompts wait for you in the terminal.
PhoneWhether the watch can reach your phone, nearby or over the internet.