Skip to content

Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.

docs: list what the Android app hasn't finished yet

leepokai985cc0ce256d
diff --git a/docs/plans/android-app.md b/docs/plans/android-app.md
index a129c59b..cfbb4e20 100644
--- a/docs/plans/android-app.md
+++ b/docs/plans/android-app.md
@@ -1,6 +1,7 @@
# Android parity and acceptance
-Status: **in review** (PR #151). The Android app is a 1:1 port of the iPhone app: each screen
+Status: **in development, merged into `dev`** (#151, #152, #154, #155), not released yet. The
+Android app is a 1:1 port of the iPhone app: each screen
is built from its iOS source (`apps/ios/Views`, `apps/ios/Kit/Sources/CodyncUI`) with the
Android `design` module (see the [Android README](../../apps/android/README.md)). Product
logic stays in the host. This checklist tracks what's still different and what still needs
@@ -23,7 +24,7 @@ emulator against a real host; device acceptance is listed separately.
| Routines | Ported: list with switches, editor (schedule, webhook panel, run settings), test run, delete | Live provider/routine acceptance |
| Extensions | Ported: agents (install, sign-in, setup terminal), registry connectors, Composio apps, skills, installed list, custom connector, own skill, credentials, chat connection request card | Real provider OAuth, 1Password |
| Voice | Ported: call bar (provider name, fallback notice), Voice chat settings (engine, mode, models, voice, minutes this month), on device (the call's language through Android's on-device recognizer, Vosk English as the fallback, replies read by an offline voice for their language), OpenAI Realtime (WebRTC), Gemini Live, Speech mode, fallback to on device, group calls | Both providers with a real key on a device; a live microphone on a device |
-| State/widgets | Ported: Widget (with the animated Add a widget guide), Live update and Status bar pages, Usage sheet, Choose the look; Provider usage, Usage limits, Bots and Team widgets with launcher Edit widget and picker previews (Android 15+); the Bots Quick Settings tile (iOS's Control Center control) | Physical launcher refresh; the tile opens Codync, not Computers, when no bot is at work |
+| State/widgets | Ported: Widget (with the animated Add a widget guide), Live update and Status bar pages, Usage sheet, Choose the look; Provider usage, Usage limits, Bots and Team widgets with launcher Edit widget and picker previews (Android 15+); the Bots Quick Settings tile (iOS's Control Center control) | Physical launcher refresh |
| Notifications | Ported: alerts as conversations with the bot's face (a group's face and its speaking member), conversation shortcuts, what happened ("Task complete") as sub text | Android's conversation layout doesn't draw sub text; background delivery needs FCM in the deployment |
| Live updates | Android 16 Live updates (`ProgressStyle`), the status bar chip on Android 16 QPR1 (API 36.1) | Background updates need FCM in the deployment |
| Version check | `VersionMismatch.MIN_HOST`, the host's `minApp`, the update card in the roster and in place of the composer | Set `MIN_HOST` to the first release that ships Android support when it's cut |
@@ -36,8 +37,42 @@ emulator against a real host; device acceptance is listed separately.
- [x] `./gradlew :core:test :app:testDebugUnitTest :app:assembleDebug :app:assembleDebugAndroidTest :app:assembleRelease :app:lintDebug` passes (CI and the pre-commit hook run it).
- [x] Every screen above walked through on an API 36 emulator against a disposable host, in light and dark mode, side by side with the iOS simulator.
- [x] Live update and its status bar chip on an API 36.1 emulator.
-- [ ] `AppStore.kt` split by responsibility (clean-code size rule), undecodable events stop after one rewind and show *Update this app*, timeouts surface as errors.
-- [ ] Instrumentation suite run on an emulator.
+- [x] `AppStore.kt` split by responsibility (clean-code size rule), undecodable events stop after one rewind and show *Update this app*, timeouts surface as errors.
+- [ ] Instrumentation suite run on an emulator: only single classes so far (`PlatformSpeechTest`, `AlertNotificationTest`, probes), through `am instrument` because Gradle's connected run uninstalls the paired app.
+
+## Not done yet
+
+Where the Android app still falls short, as of 2026-10-18. Everything else in the table above
+was walked through on an emulator against a real host.
+
+### Not verified (needs an account, a key, a device or the real Mac)
+
+| What | Code | What it needs |
+| --- | --- | --- |
+| Revoke this phone's access; removing older copies of the computer from the account | `core/.../CloudClient.kt` (`revokeAccess`, `removeComputer`), `SettingsView.kt` | A signed-in account on the emulator or a phone; only request tests cover it |
+| Push delivery (alerts, background Live update refresh) | `PushService.kt`, `AppStoreNotifications.kt` | A Firebase project and the push Worker's FCM secret (owner's go-ahead). The notification look is covered by `AlertNotificationTest` |
+| OpenAI Realtime, Gemini Live and Speech mode with a real key | `WebRtcPeer.kt`, `core/.../OpenAIRealtimeEngine.kt`, `GeminiLiveEngine.kt`, `CloudSpeechEngine.kt` | A provider key on the paired computer; the fallback to on-device voice is verified |
+| Remote screen: Chinese IME composition, a hardware keyboard, the TURN relay path and its credential renewal | `ScreenKeys.kt`, `ScreenSession.kt`, `ScreenView.kt` | A computer it's safe to type into, and a signed-in host for the relay; viewing, trackpad and pinch zoom are verified |
+| On-device voice with a live microphone | `PlatformSpeech.kt`, `LocalVoiceAudio.kt` | A phone; on the emulator the recognizer was fed the speech fixture |
+| Camera QR pairing, launcher widget refresh, rotation, foldables, large text, TalkBack end to end | `QrViewfinder.kt`, `CodyncWidgets.kt` | Physical devices |
+
+### Different from the iPhone on purpose or by platform
+
+- **Notification subtitle**: "Task complete" / "Response needed" / "Task failed" is the
+ notification's sub text, which Android's conversation layout doesn't draw (`PushService.kt`).
+- **Bots tile** refreshes when Quick Settings opens, not live; between two bots that need you
+ equally it picks the pinned one, the iPhone the most recent (`core/.../WidgetFeed.kt` `leadBot`).
+- **Shared files**: leaving the chat during a download skips the share sheet when it finishes
+ (the card shows *Downloaded*); shared copies are deleted after a day (`AppStoreFiles.kt`,
+ `AttachmentFiles.kt`).
+- **Pull to refresh** on the roster and in Settings uses the chat's indicator; iOS uses the system one.
+- **`computers` / `plugins` links** open over the current tab; iOS switches to Bots first.
+- **On-device voice**: languages other than English need Android 13+ and Android's on-device
+ recognizer; it never falls back to online recognition (iOS may use Apple's servers).
+- **Jump to latest** is an opaque disc: it sits in the scrolling content, so there's no blur under it.
+- **Not ported**: the computer filter's hide toggle and *This computer was removed* (one computer
+ per phone on Android, and removing it reloads the app), *Create template* (nothing opens it on iOS).
+- **Multiple computers**: one per phone ([future work](../architecture/overview.md)).
## Before a Play release