# iPhone and the web app

## Install Sensei from your browser

On a computer, you can install the web app so it opens in its own window. In Chrome or Edge,
open app.kosuke.ai and use the browser's install option.

Sensei needs a network connection. Without one, the installed app shows "You are offline"
and a **Try again** button.

## Get the iOS app

The Sensei iOS app, **Sensei by Kosuke**, is a beta on TestFlight. It runs on iPhone and iPad.

1. On your iPhone or iPad, open [the TestFlight invitation](https://testflight.apple.com/join/nDRPWCXw).
2. Install TestFlight if it asks, then install Sensei from the invitation.
3. Open Sensei from your home screen and sign in with **Continue with Apple**, **Continue with
   Google** or your email address. With your email, Sensei sends you a code: type it, or let iOS
   fill it in from Mail.

The app stays signed in until you press **Log out** in Settings. A new account, or one that has
not finished setting up, cannot sign in yet: the app says to finish setting up your account on
the web, then sign in again.

The current app is a new, native Sensei app that replaced the previous one on 13 November 2026.
If you had the previous app, TestFlight installs the new one as an update. Sign in again after
updating.

Sensei opened in Safari, Chrome or any other browser on an iPhone or iPad shows "Use the Sensei
app" instead of the app. Its **Get the app on TestFlight** button opens the TestFlight invitation
of the Sensei app. If you already have the app, open Sensei from your home screen. The page also
says "Or open Sensei on a computer."

Android phones and tablets, and every other phone or tablet, have no app. A browser on one
shows "Open Sensei on a computer" and "The Sensei app is for iPhone and iPad only." Open
Sensei on a computer instead. A home-screen web app installed from a phone browser shows the
same page.

In the iOS app, a link to a thread or a task opens it in the app. A link to another website opens
in your browser, or in the app that owns it when it is on your phone, such as GitHub or Slack.

A few pages still open in a phone or tablet browser, because people reach them from a link or
from another device. They are a shared preview and its error page, an invitation link, the GitHub
install page, and the pages that approve a sign-in from your Watch or glasses or let an AI app
connect to your account, with sign-in on the way to those two. Accepting an invitation works
in a phone browser. Then finish setting up your account on a computer.

## Not in the current iOS app yet

The new app does not have these yet. They come back in a later update:

- The Home Screen and Lock Screen widgets.
- The Control Center controls.
- The Siri and Action button shortcuts.
- **Sensei** in the share sheet, to share photos and files from another app.
- The Apple Watch app. See [Apple Watch](https://kosuke.ai/docs/devices/watch.md).

To send a photo or a file now, open the composer in Sensei and press **+**.

## Use Sensei on a phone

The iOS app has a tab bar at the bottom with **Home**, **Threads**, the Sensei button, **Tasks**
and **Settings**. Tap a tab, or swipe sideways on the tab bar or from the edge of the screen, to
move one tab. The app opens on **Home**.

- **Home** is [Deck](https://kosuke.ai/docs/sensei/cards.md#reels): your cards one at a time. Swipe a card right to
  approve it or left for its negative button. **Undo** holds the decision for 5 seconds before
  anything is sent. See [Approve, Reply and Reject](https://kosuke.ai/docs/sensei/cards.md#approve-reply-and-reject).
- **The Sensei button**, in the middle of the tab bar, starts a new thread. Tap it to write in a
  composer that opens over the page you are on, with **+** for photos and files and the model
  picker. Hold it to talk: when you let go, your words go as a new thread at once. See
  [On iPhone](https://kosuke.ai/docs/sensei/voice.md#on-iphone). A new thread flies into **Threads** as you send it, and
  Sensei works on it in the background.
- **Threads** lists your threads, pinned first. **Filter** narrows them by type (**Inbox**,
  **Tickets**, **Work** and **Routines**) and by state, **Archived** included. **Search** finds a
  thread or a task. Swipe a thread right to pin it, or left for **Done** and **More**. Press and
  hold a thread for **Rename**, **Pin**, **Mark done** and **Archive**.
- A thread opens on its own page, with its messages and its cards where Sensei posted them. Write
  in the composer at the bottom. Hold its microphone to send a voice message. While Sensei works,
  your message steers it, and **Stop** ends its turn. The **…** button holds the thread's actions
  and its tasks.
- **Tasks** shows your tasks by status, **In progress** first. **Filter** picks the statuses, the
  owner and the priority. A task opens on its own page, where you can change its details or start
  it.
- **Settings** has a **You** group with **Account**, **AI Providers**, **Token Usage**,
  **Skills**, **Integrations**, **API keys**, **Devices**, **Preferences**, **Sign as Sensei** and
  **Privacy**. **Sign as Sensei** shows whether it is On or Off; open it to change your default.
  **This iPhone** holds **Notifications** and **Share location**. Each of your workspaces has its
  own row, and **Log out** sits at the bottom.

Pages you open from a tab slide in from the right. Press **Back** or swipe from the left edge to
go back. Some of Sensei is not in the app: the workspace Overview, projects, and Files, Crons and
Repositories in Settings. Use them on a computer.

A computer browser window narrower than 768 pixels shows the web's phone layout instead. It
opens on Deck, with your avatar on the left of the header, **New thread** in the middle and
**Search** on the right. Your avatar opens Settings. Pages that need a wider screen, such as a
project or the Overview, show "Open this on a computer" with a **Copy link** button.

## Share your location with Sensei

In the iOS app, Sensei can know where you are. It then answers questions such as what is near
you, which city to plan the day in, or which time zone to use. Sharing is off until you turn it
on, and only the iOS app shares a location.

1. In the iOS app, open **Settings**.
2. Under **This iPhone**, turn on **Share location**.
3. iOS asks to use your location. Choose **Allow While Using App**.
4. iOS can then offer **Always**. Choose **Change to Always Allow** to share after large moves
   while the app is in the background or closed too. With **While Using** only, the app shares
   only while it is open.

Sensei gets your coordinates, how accurate they are, and your phone's time zone. It uses a
location for up to 24 hours. After that, it uses your [Memory](https://kosuke.ai/docs/your-day/memory.md) again. Sensei
keeps only the last location, never a history.

To stop, turn the switch off. Sensei deletes the stored location. Logging out on the phone,
removing it in **Settings > Devices**, or turning location off for Sensei in iOS Settings also
deletes it. Sensei's threads keep what it already said with the location.

When iOS location is off for Sensei, the switch reads "Off in iOS Settings" and cannot be turned
on. Allow the location for Sensei in iOS Settings first. iOS may not read your location after you
close the app by swiping it away, or while your phone is locked.

## Limits

- Sensei does not open in a browser on a phone or a tablet. There is no way to continue in the
  browser from the page it shows.
- Android has no app. Use Sensei on a computer.
