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.
Codync Android
A native Kotlin/Compose phone client using the existing host's encrypted channel
and account APIs. It follows the iPhone app screen for screen (layout, wording,
motion and the Liquid Glass look), built from the iOS sources in
apps/ios/Views and apps/ios/Kit/Sources/CodyncUI. What's still missing is in the
parity and acceptance checklist.
Build
Use JDK 21, Android SDK 37 and Build Tools 37.0.0. Set JAVA_HOME and
ANDROID_HOME, or set sdk.dir in ignored local.properties.
cd apps/android
./gradlew :core:test :app:testDebugUnitTest :app:assembleDebug :app:lintDebug
./gradlew :app:assembleRelease
adb install -r -d app/build/outputs/apk/debug/app-debug.apk
Stop the old app before rebuilding. Upgrade with adb install -r -d, using the
original package and signing key; retain device data and identity (-d lets a debug
build from an older version replace a newer one). The checksum-pinned
Gradle wrapper is checked in. versionName follows apps/project.yml and
versionCode is derived from it (2.24.0 → 2024000). Feature PRs do not bump product versions.
Release builds are signed with the Google Play upload key when codyncUploadKeystore
and codyncUploadKeystorePassword are set (codync.local.properties or -P), and stay
unsigned otherwise. ./gradlew :app:bundleRelease makes the bundle Play takes; releases
reach Play through the Submit Android workflow (Android releases),
with the release notes in WhatsNew.md here.
Account and push configuration
A clean checkout builds com.pokai.Codync.android.dev (Codync Dev) or
com.pokai.Codync.android (Codync). Debug/release read their account configuration from
apps/shared/Config/dev.plist and main.plist. The default push relay comes from
CodyncKit/Client/SharedStore.swift.
Firebase client configuration is deployment-specific and excluded from Git (the
official one comes from the codync-auth Firebase project: a CI secret, and
codyncGoogleServicesFile locally). Without it the app builds, pairs and chats;
Account and State explain that push is unavailable. It does not request notification permission or schedule FCM
registration in that configuration. Foreground task status remains available.
For a private deployment, create ignored apps/android/codync.local.properties.
Override cloud, Clerk and push relay together; partial tuples fail the build.
Command-line Gradle properties take precedence over this file.
codyncApplicationId=com.example.codync
codyncAppName=Codync Local
codyncCloudUrl=https://cloud.example.com
codyncClerkPublishableKey=YOUR_MATCHING_CLERK_PUBLISHABLE_KEY
codyncPushRelayUrl=https://push.example.com
codyncGoogleServicesFile=/absolute/path/to/google-services.json
The Firebase client file must contain the final package names, including .dev
for debug. Its matching service account belongs only in the push Worker's
FCM_SERVICE_ACCOUNT secret, never in the app. Before installing a private APK,
check its generated BuildConfig, package, Firebase project and certificate
against the saved deployment configuration. Compilation alone does not verify
which backend the app will use.
Pair and use
Run codync-host pair on the computer and scan its code or paste the resulting
codync://pair link (codync-dev://pair for Codync Dev, which pairs only with a
development host). Setup shows the Mac and Linux install paths, as on iOS. Pairing links
and one-time codes remain in memory. Account login discovers computers; each
host must still approve access.
Pair as many computers as you like, as on the iPhone: AccountStore keeps one
AppStore (link, mirror, drafts) per computer, and the roster shows a heading per
computer once there are several. Accounts have separate device keys, mirrors,
files, image caches and composer drafts.
Remote screen negotiates incremental ICE with hosts and helpers that advertise support. It exchanges offers and answers while candidates are still gathering, buffers candidates until the answer is installed, and keeps established media running through a brief signaling disconnect. Older hosts and helpers continue using complete SDP.
The roster shows activity, previews, unread counts, groups, pin/hide actions and sections (Move to section in a bot's menu; tap a section's header to fold it on this phone, touch and hold it to rename or remove it; bots in none sit under a "Bots" label); touch and hold a bot, then move it, to reorder within its section (the order syncs through the host). Cached bots remain readable offline and are labeled as saved. An unreachable computer is distinguished from an empty online roster. Chat supports final replies, Markdown/code, permissions, reactions, quote replies (touch and hold a message, then Reply), history and Full conversation.
Text and private attachment drafts survive process death separately for each bot. Sends retain their nonce through durable queue commit and retry. Uncertain sends require explicit retry with the same ID. Text can wait in the encrypted relay mailbox; files require a live computer. Files are capped at 100 MiB each and uploaded in 384 KiB chunks. Sharing uses a temporary copy rather than exposing the private cache.
Ownership and storage
app: Compose screens, Android lifecycle, Keystore-wrapped identity, account-scoped storage, files, notifications and widgets.core: JVM models, crypto, pairing, RPC and transport. The host retains bot, agent, memory, routine, connector and other product logic.design: Codync's design system on Android, mirroring CodyncUI:Palette,Type(Inter, since SF Pro ships only on Apple platforms),Motion, glass (Glass.kt, Kyant backdrop: blur, lens refraction and highlight standing in for Liquid Glass), sheets, menus, dialogs, controls and avatars.Symbol("sf.name")draws the Material Symbols Rounded stand-in for each SF Symbol the iOS app names (python3 tools/symbols.pyregenerates them; SF Symbols may not ship on Android). Screens use these components, never Material widgets beyondText.
Ed25519/X25519 seeds use Android Keystore AES-GCM wrapping; no global crypto provider is replaced. Local data is excluded from backup and device transfer. The mirror commits updates, send reconciliation and the event cursor together. Context retirement joins writers before changing identity or closing databases. A changed host identity produces an error rather than silently trusting new keys.
Direct HTTP/WebSocket connections use Codync's encrypted channel. Cloud URLs require HTTPS. Minimum API is 29 and target API is 36; declared minimums do not establish device acceptance. Targeting API 37 requires local-network permission work.
Validation
./gradlew :app:assembleDebugAndroidTest
./gradlew :app:connectedDebugAndroidTest
Use the shared test emulator,
under its lock, for ordinary instrumentation: it includes local reset and
credential fixtures. Do not run it against a personal phone's
saved accounts. Mutating live suites require fixtureComputerId matching an
isolated fake-agent host. Shared vectors come from
remote-relay-vectors.json.
LiveChatTest uses liveHost=true and a bot named Android chat acceptance
running fake_agent.py. LiveDraftTest uses draftPhase=prepare and restore with an OS process
stop between phases. File acceptance verifies a multi-chunk round trip byte for
byte. LiveRosterTest offers separately opted-in read-only inspection of an
existing connection; it is not the ordinary reset suite.
The emulator-only -PcodyncReleaseTests=true variant signs an R8 acceptance build
with the debug key; ordinary release builds take only the upload key. Physical camera,
keyboard/TalkBack, provider login, background push, voice and release acceptance
are separate checklist gates.
Dependencies and assets
Versions are pinned in libs.versions.toml. Terminal
packages, hashes and MIT notices are in
vendor-manifest.json.
python3 tools/vendor-terminal.py regenerates them from integrity-checked npm
archives using pinned esbuild. The terminal exposes only a constrained bridge
and explicit HTTP links. Vosk/JNA and the checksum-verified English model have
notices in voice-manifest.json.
That speech prototype does not establish full voice parity.
AndroidX, Compose, CameraX, Glance, WorkManager, Firebase, Play app update and desugaring artifacts come from Google Maven. Other dependencies use the configured repositories. AndroidX native libraries, Vosk and JNA are upstream artifacts; no custom native crypto or camera library is introduced. WebRTC comes from the webrtc-sdk build of libwebrtc.
| Dependency | Version | Source/license and role |
|---|---|---|
| Gradle | 9.6.0 | Gradle, Apache-2.0; checksum-pinned wrapper |
| Android Gradle plugin | 9.4.1 | Compatibility, Apache-2.0; SDK 36 build |
| Kotlin and Compose compiler | 2.4.20 | Kotlin, Apache-2.0 |
| Compose BOM | 2026.09.00 | AndroidX, Apache-2.0; UI components |
| AndroidX Activity / Lifecycle | 1.12.2 / 2.10.0 | AndroidX, Apache-2.0; platform lifecycle |
| Coroutines / serialization | 1.10.2 / 1.9.0 | Kotlin libraries, Apache-2.0; concurrency and JSON |
| OkHttp | 4.12.0 | Square, Apache-2.0; WebSockets and test server |
| Bouncy Castle | 1.86 | BC Java, BC license; lightweight Ed25519/X25519/ChaCha20-Poly1305 |
| JUnit / AndroidX Test | 4.13.2 / runner 1.7.0 / ext 1.3.0 | JUnit, EPL-1.0; AndroidX Test, Apache-2.0 |
| CommonMark and GFM extensions | 0.30.0 | CommonMark Java, BSD-2-Clause; selectable Markdown, tables and strikethrough |
| Coil | 3.4.0 | Coil, Apache-2.0; bounded image loading and caching |
| Java API desugaring | 2.1.5 | Android desugaring, GPL-2.0 with Classpath Exception; CommonMark runtime support |
| Clerk Android | 1.1.11 | Clerk SDK, MIT; native account sessions and browser/provider authentication |
| Firebase BOM / Google Services plugin | 34.19.0 / 4.5.0 | Firebase Android, Apache-2.0; FID registration and data-only FCM delivery |
| Play app update | 2.1.0 | Play Core, Play Core SDK Terms; the update notice and reminder |
| WorkManager | 2.12.0 | AndroidX Work, Apache-2.0; bounded background registration retries |
| Glance | 1.2.0 | AndroidX Glance, Apache-2.0; responsive native app widgets |
| CameraX | 1.6.2 | AndroidX Camera, Apache-2.0; lifecycle-bound preview/analysis, minimum API 23, optional camera permission |
| ZXing Core | 3.5.4 | ZXing releases, Apache-2.0; bundled Java QR decoding without a network/model download |
| xterm / fit / web-links | 6.0.0 / 0.11.0 / 0.12.0 | xterm.js, MIT; bundled terminal rendering and explicit HTTP links, with each license included in the assets |
| Vosk Android / English model | 0.3.75 / small-en-us-0.15 | Vosk, Apache-2.0; bundled offline recognition and checksum-pinned model |
| JNA | 5.18.1 | Java Native Access, Apache-2.0 option with notice; native speech binding |
| WebRTC (webrtc-sdk) | 125.6422.07 | webrtc-sdk/android, BSD-3-Clause; remote screen video and input channels, OpenAI Realtime voice |
| Kyant backdrop / shapes | 2.0.1 / 1.2.1 | AndroidLiquidGlass, Apache-2.0; glass blur, lens and highlight (RenderEffect API 31+, RuntimeShader API 33+), continuous-corner shapes |
| Inter | 4.x variable | Inter, OFL-1.1; the app's type face in design/src/main/res/font |
| Material Symbols Rounded | upstream SVGs | Material Design Icons, Apache-2.0; vector stand-ins for SF Symbols |
| esbuild (asset regeneration only) | 0.28.2 | esbuild, MIT; transforms newer syntax for older WebViews, never included as an APK binary |