# Apple Watch

> **Warning.** The Watch app is in progress. It ships inside the Sensei iOS app, and the current iOS beta on
> TestFlight does not include it yet. This page describes the Watch app as it is built today.

Sensei on Apple Watch shows your cards one at a time and takes your answer with a tap, a swipe
or your voice. The Watch talks to Sensei directly over its own connection, so it works without
your iPhone nearby as long as it is online. It needs watchOS 10 or later.

## Sign in

The Watch has no keyboard, so it signs in with a code from your Sensei account:

1. Open Sensei on the Watch. It shows a QR code, a short code under it, and the address to
   type it at, `app.kosuke.ai/device`.
2. Scan the QR code with your iPhone camera, or open `app.kosuke.ai/device` on your iPhone or a
   computer and enter the code. Sign in to Sensei if it asks.
3. Check the code and press **Approve**.

The Watch signs in by itself once you approve. An expired code is replaced by a new one. After
**Deny**, the Watch says "Sign-in denied." and offers **Try again**.

The Watch then shows up in **Settings > You > Devices** under **Watch and glasses**, with when it was
last used. See [Devices](https://kosuke.ai/docs/workspace/account-and-preferences.md#devices).

### Sign out

Deck's end screens, such as **All caught up**, show **Signed in as** with the account, and
**Sign out**. With cards on screen, put them in Later to reach it. Sign out asks first, stops the
Watch's notifications, clears its cards and shows a new sign-in code. Pressing
**Remove** on the Watch in **Settings > You > Devices** on your iPhone or a computer signs it out too.

## Deck and New thread

The app opens on **Deck**, your open cards one at a time: the same cards as
[Deck](https://kosuke.ai/docs/sensei/cards.md#reels) on the iPhone and the desktop, from every workspace you belong to.
The title next to the clock switches between the two: it reads **+ New thread** on Deck and
**< Deck** in New thread. Deck keeps its card and its scroll while you are away.

The Watch has no Needs you list, no Tasks page, no search and no settings.

When no card waits, Deck reads **All caught up**. If the cards could not be read, it says
**Your cards did not load** with **Try again**, and keeps the cards it read last.

## Read a card

A card shows its headline, its project and its text. Scroll with your finger or the Digital
Crown. Tap the card to open its thread. Parts of a card open their own screens:

- **Task row**: the task's status, its title and its pull request. Tap it to open the task's
  details.
- **QA recording**: tap it to open the video player. It plays and pauses, and you scrub with the
  Digital Crown. The video has chapters, and the player shows the current one.
- **QA passed**: shows how many checks passed, such as 5/5, in green when all pass, red on a
  failure and amber when blocked. Tap it to open the QA items.
- **File**: tap it to read a preview, or use **Read all on iPhone**.
- **Prototype**: step through its states with previous, next and the Digital Crown. Tap a
  picture to zoom it.
- **Questions**: one step per question, with Sensei's recommended option picked. Tap an option
  to pick it and move on. **My own answer…** takes your answer by voice. Nothing is sent until
  the last step, where you check your answers and press **Send**.

## Decide a card

The footer has three round buttons: red for the card's negative button, such as **Reject**,
**Drop** or **Skip**, a microphone in the middle to reply by voice, and green for its verb, such
as **Merge**, **Approve** or **Ok**. The word over each button says what it does.

You can also swipe:

- Swipe right to accept.
- Swipe left for the negative button.
- Pull down past the top of the card to put it in **Later**.

The next card shows at once. The decided card stays above it as a strip in its colour, with
**Undo** and a line that empties over 4 seconds. Nothing is sent before then, and each decision
has its own 4 seconds. **Undo** takes back the newest one. Once sent, the strip shows a green
check. A failed send reads **Not sent** with **Show**. Leaving the app sends held decisions at
once.

A card in Later is put off on every device for 30 minutes, or until something new happens on it.
When only Later cards are left, Deck reads, for example, **3 cards wait in Later** with **Bring
back all 3**.

## Reply and start a thread by voice

Press the microphone on a card to reply, or open **+ New thread**, which starts listening at
once. A full-screen light behind Sensei's mark shows while the Watch listens and thinks, except
under Reduce Motion.

The recorder has **X** and a green **Send**. **Send** stops, transcribes and sends in one step,
with no review. Nothing else sends: not the microphone, not Back and not lowering your wrist.

- A reply moves its card behind the others. The strip says **Sending reply**, then **Reply
  sent**, and Sensei answers in the thread.
- Going back keeps your words on the card as **Your reply, not sent**. A failed send keeps
  them with **Retry**.
- A new thread shows **Starting the thread**, then opens by itself. Leaving New thread keeps
  what it heard as a draft, marked by a white dot on Deck's title.
- Silence shows **I heard nothing** with **Try again**. A blocked microphone shows
  **Microphone is off** with **Type instead**.

## Act from a notification

Only Sensei notifies the Watch. While the app is on screen, Sensei sends it no notification.
Tap a notification to open its thread. Some notifications have buttons:

| Notification           | Buttons                                      |
| ---------------------- | -------------------------------------------- |
| A card to approve      | **Approve** or **Merge**, and **Later**      |
| A question             | One numbered button per option, and **Own answer** |
| Any other card         | **Open**                                     |

**Approve**, an option and **Own answer** act as the card's own buttons. **Later** leaves the
card open. A notification you opened or decided on another
device leaves the Watch too. See [Notifications](https://kosuke.ai/docs/sensei/notifications.md).

## Complications

Two complications and Smart Stack widgets open the app:

- **Deck** counts the cards that wait. The round one fills an arc up to 10 cards. The wide one
  reads "N cards need you" with the first card's headline, or "All caught up". Before a first
  read it says "Not loaded yet".
- **New thread** shows Sensei's logo and opens New thread, listening.

## Limits

- The current iOS beta on TestFlight does not include the Watch app.
- The Watch needs a connection to reach Sensei. Without one it keeps the cards it read last.
- A card that asks for values, such as a Deploy form, says "Values are never typed on the Watch.
  Enter them on iPhone or the web."
- A file or prototype the Watch cannot show opens on your iPhone.

## Next steps

- [Cards and the Deck](https://kosuke.ai/docs/sensei/cards.md) explains the cards the Watch shows.
- [Notifications](https://kosuke.ai/docs/sensei/notifications.md) covers how notifications reach every device.
- [iPhone and the web app](https://kosuke.ai/docs/devices/iphone.md) covers the Sensei iOS app.
