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.
Analytics events
Every event Codync records, who sends it and what it carries. The rules (feature use only,
never content; one switch per device; identity) are in usage analytics.
A property is a count, a boolean, a public catalog name or one of the values listed here; a
value outside the list is other. Add an event here in the same change that sends it.
Common properties on every event: env, app_version, $os, $lib, $session_id.
Senders
$lib |
Sender | Path |
|---|---|---|
codync-host |
The host, for every client's API calls, its own start, phone pairing and connections, and the events the desktop app and terminal UI report through track |
host/src/analytics.rs, host/src/analytics/ |
codync-ios |
The iPhone app | apps/ios/Kit/Sources/CodyncKit/Analytics/ (AnalyticsEvent.swift), CodyncUI/AnalyticsTracking.swift |
codync-android |
The Android app | apps/android/.../Analytics.kt, AnalyticsEvent.kt |
codync-desktop |
The desktop app's main process, only for host setup failures (no host to report through) | apps/desktop/src/main/analytics.ts |
web |
codync.dev, cookieless | web/app/analytics.tsx |
Host events also carry computer (the computer's key) and arch. Host events from API calls
carry client: local (desktop app, terminal UI, CLI) or remote (a phone), and for
remote the phone's platform (ios, android, macos).
track: what the desktop app and terminal UI report
POST /api/track (loopback only) takes {"event": "<name>", ...properties}. The host accepts
only the events and properties below (analytics::Reported, a typed enum) and drops anything
else, so a client can't send content by mistake. Every reported event carries app
(desktop/tui, desktop when missing). The desktop app keeps what it reports before the
host answers and sends it once the host is up.
Onboarding and conversion
| Event | Sent by | When | Properties |
|---|---|---|---|
app_opened |
host track (desktop, TUI), iOS, Android |
Desktop: each launch, once the host answers. TUI: each start. Phones: each return to the foreground. | desktop at_login (opened by the login item); phones notifications (allowed/denied/not_asked), widgets (count on the Home Screen) |
window_opened |
host track (desktop) |
The chat window is shown after being hidden (tray, dock, shortcut, second launch). A long-running menu bar app opens it many times per launch. | — |
window_recovery |
host track (desktop) |
A window's page crashed (RendererGone in error tracking): it loaded again, or crashed too often and stays down |
outcome (reloaded/gave_up) |
host_started |
host | Each start of the host process | first_run (the first start of a new install; open_store marks a new host id with an empty analytics_version), updated_from (the previous version, when it changed), service (started by launchd, systemd or the Windows runner: XPC_SERVICE_NAME, SYSTEMD_EXEC_PID, CODYNC_SERVICE) |
host_setup_failed |
desktop main | The desktop app couldn't get a working host | stage (missing_binary/install/verify/not_responding/environment) |
onboarding_step_viewed |
iOS, Android | An onboarding screen appears. welcome is also the sign-in screen, so it's sent again after each sign-out: count persons, or the first one per person, for first runs |
step (welcome/choose/install/scan; choose: the account has computers, ask one or pair a new one) |
onboarding_completed |
host track (desktop), iOS, Android |
Once per setup. Desktop: the first run's welcome is finished (by signing in, in a build with accounts). Phones: the first-run screens are finished and the tabs appear (a computer reached, or skipped). | desktop signed_in; phones via (paired: by its code; account: approved after asking; skipped) |
computer_access_finished |
host track (desktop) |
The Computer access step is left | ready (screen recording and control granted), onboarding |
sign_in_started |
host track (desktop), iOS, Android |
A sign-in button is pressed | provider (apple/google/github/hosted) |
sign_in_failed |
host track (desktop), iOS, Android |
Sign-in ended without an account | provider, reason (cancelled/timeout/verification/error) |
signed_in |
host track (desktop), iOS, Android |
Signed in to a Codync account | provider |
signed_out |
host track (desktop), iOS, Android |
Signed out | — |
signed_out_pairings_moved |
iOS, Android | At sign-in, computers paired while signed out (before sign-in was required) moved into the account | computers (count), keys (moved: this phone's keys went along, nothing to scan; rescan: the account already had its own key on this phone, so they need a new scan) |
continued_without_account |
host track (desktop), iOS, Android |
Continue without an account on the welcome screen | — |
add_to_account_asked |
iOS, Android | Add to account on a computer in no account | — |
add_to_account_completed |
iOS, Android | That ended with the computer in the account | — |
add_to_account_failed |
iOS, Android | That ended without the computer joining | reason (declined/certificate/unreachable/other) |
join_from_phone_answered |
host (joinAccount) |
The computer answered a paired phone's Add to account | outcome (approved/declined) |
discovery_failed |
host | A computer in no account couldn't advertise on the local network, reported once per host run | stage (start/update) |
join_offer_answered |
host track (desktop) |
The ask to add a computer to the signed-in account ended | outcome (added/kept_out/failed) |
computer_found_on_network |
iOS, Android | A phone reached a computer in no account at an address it found on the local network | — |
pairing_code_created |
host (pairing) |
A pairing QR code is made (desktop, terminal UI, codync-host pair), including each new one an open pairing screen makes when its code expires: count persons, not events |
client |
pairing_failed |
iOS, Android | A pairing attempt fails | reason (not_pairing_link/outdated_host/invalid/expired/unauthorized/unreachable/timeout/upgrade_required/other) |
computer_paired |
iOS, Android | The phone reached a computer | via (qr: scanned or pasted on the scan screen; link: a pairing link opened from outside; account), computer |
device_paired |
host | A phone was added: a pairing code redeemed or an account request approved | via (qr/account), platform, automatic (approved without a tap), account (joined: in the computer's account, or the computer joined the phone's; phone_only: signed in, the computer stayed out; signed_out) |
access_requested |
iOS, Android | The phone asks an account computer for access | — |
access_request_failed |
iOS, Android | The request ended without access | reason (denied/expired/cancelled) |
access_request_denied |
host (decideAccessRequest) |
The computer's owner denied a phone | client |
device_revoked |
host (revokeDevice) |
A phone's access was removed | client |
phone_connected |
host | A paired phone connects, at most once per phone per UTC day | platform, route (direct/relay: how that first connection of the day came in) |
notifications_answered |
iOS, Android | The system notification prompt was answered | granted, source (settings/widgets/automatic) |
notification_opened |
iOS, Android | A Codync notification was tapped | kind (done/needs_input/failed) |
star_prompt_answered |
host track (desktop) |
The GitHub star setup invitation or the fifth-prompt invitation was answered or closed | ask (first/second), starred |
link_opened |
host track (desktop), iOS, Android |
An outbound link was opened (install_command: an install command copied; install_link: the phone's website link copied) |
link (github/docs/issues/discord/app_store/demo/tailscale/privacy/support/install_command/install_link/product_hunt) |
Using Codync
| Event | Sent by | When | Properties |
|---|---|---|---|
screen_viewed |
host track (desktop, TUI), iOS, Android |
A screen, sheet or tab is shown | screen (see Screens) |
bot_created |
host | createBot |
kind (bot/group), agent, model or members (count) |
bots_imported |
host | importBots (bots it makes send no bot_created) |
source (grok-bot/openbot/other), bots, groups (counts) |
bot_updated |
host | updateBot |
fields: the settings that changed, as the bot config's own camelCase keys (model, permission, pinned, section, modelOptions, fastMode, …), never their values; when the edit changes compaction, also compaction: the kind picked (early/nearLimit/off/tokens, never the size) |
bots_reordered |
host | reorderBots |
— |
section_renamed |
host | renameSection |
removed: whether it removed the section (to empty or null); never the names |
bot_deleted |
host | deleteBot |
— |
message_sent |
host | send (a resend counts once) |
kind, agent, reply (whether it quotes a message), attachments (count) |
message_steered |
host | Send now on a queued message (steer), once its outcome is known |
agent, how (joined the running turn / next turn, the turn ended first / interrupted the user's turn / moved_up behind other work / failed, it waits) |
queued_message_removed |
host | Remove on a queued message (unqueue) |
— |
turn_stopped |
host | stop |
— |
turn_finished |
host | An agent's turn ends: once per agent it ran on, so a turn that fell back once and then answered sends a failed and a done |
agent, outcome (done/stopped/failed/needs_setup/incomplete; needs_setup is a failure whose error is sign_in or not_installed: the user has a step to take, nothing broke), stop_reason, source (user/routine/group/bot/host: the lead opening a call), seconds; when failed or needs_setup, error (not_installed/timeout/exited/no_model/sign_in/agent_error/io/other) and, for agent_error, rpc_code and agent_reason (the adapter's own category, else one the host reads from the message, which is never sent: session_ended/rate_limit/quota/overloaded/context/model/network/provider/unknown) |
agent_fell_back |
host | A turn moves on to the bot's next agent (agent fallbacks) | agent (the one that couldn't answer), reason (usageLimit/outOfCredits/rateLimited/overloaded/signedOut/notStarting/modelMissing) |
context_compacted |
host | Codync starts summarizing a bot's chat (context and memory) | agent, when (turn_end/idle), threshold (the bot's Summarize long chats: early/nearLimit/tokens) |
usage_read_failed |
host | Reading an agent's usage stopped, once per failing run, for the readers that start the agent's server or read a CLI's JSON report (usage limits) | agent, stage (start/session/no_command/prompt/timeout/parse: the agent's report changed format) |
session_reset |
host | newSession |
— |
permission_answered |
host | respondPermission |
choice (allow_once/allow_always/reject_once/reject_always/other) |
reaction_added |
host | react |
— |
handoff_answered |
host | editHandoff, keepConversation |
action (edit/keep) |
routine_saved |
host | saveRoutine |
— |
routine_toggled |
host | setRoutineEnabled |
enabled |
routine_deleted |
host | deleteRoutine |
— |
routine_run |
host | runRoutine |
— |
routine_retried |
host | retryRoutineRun (the retry button on a failed run's notice) |
— |
dev_server_started |
host | A bot's start_dev_server finished |
outcome (port, no_port, exited, refused, limit, failed) |
dev_server_stopped |
host | A dev server ended | by (user, bot, restart, exited, failed) |
dev_server_action |
host (devServerStop, devServerRestart, devServerRemove, devServerLogs), host track (desktop, terminal UI), iOS, Android |
Someone acted on a dev server | action (stop, restart, remove, logs, open, copy) |
dev_server_detected |
host | A bot left a listening program running through its own shell | kind (shell) |
voice_call_started |
host track (desktop), iOS, Android |
A voice call starts, with the engine it really uses after any fallback | engine (on_device; openai/gemini realtime; cloud: cloud speech to text and back) |
voice_call_quality |
host track (desktop), iOS, Android |
One engine of a call is replaced or the call ends | engine (as voice_call_started), ready_ms (milliseconds until the provider confirmed the session and the microphone delivered; left out if it never was), reconnects, stuck (none/connecting/reconnecting over 20 s/speaking: playback stalled after the voice's turn), failure (none/microphone/connection/provider) |
voice_call_finished |
host | endCall (older apps logCall) |
seconds |
remote_screen_opened |
host | screenPrepare (each connection, reconnects included) |
— |
screen_taken_over |
host | screenTakeover (taking control, not handing it back) |
— |
connector_installed |
host | installConnector; a Composio app once its connection is active |
connector (catalog name, composio or custom) |
connectors_imported |
host | importConnectors |
count |
connector_removed |
host | removeConnector |
— |
connector_updated |
host | updateConnector, whether or not the edit was saved |
outcome (ready: how it runs changed and it passed its check; saved: name or description only; failed); on failure error (invalid, refused, wont_start, conflict, other). Never the connector, its fields, values or the error's message |
connector_signin_started |
host | connectorSignIn |
— |
skill_installed |
host | installSkill |
custom |
skill_removed |
host | removeSkill |
— |
skill_written |
host | A bot's save_skill (chatCall) |
change (new/update) |
artifact_published |
host | A bot's publish_artifact (chatCall) |
change (new/update), card (whether its card went into the bot's chat), never its title |
credential_saved |
host | A key, login or vault is saved (clearing one isn't) | kind (login/onepassword/connector/composio/voice/agent_env) |
agent_setup_started |
host | agentSetup (an agent's install or sign-in terminal) |
agent |
agent_signed_in |
host | agentAuthenticate |
agent |
reach_account_answered |
host track (desktop) |
The ask before Reach from anywhere turns on for a computer in no account ended | outcome (added/own_relay/cancelled/failed), error on failed (unreachable: the cloud couldn't be reached; refused: it refused; host: the host failed) |
setting_changed |
host, iOS, Android | A setting is switched | setting (host: remote_access/remote_access_url (on: a relay address is saved, never the address)/approval (on: approved without the code)/automatic_updates/remote_screen/cloud_assistants/usage_shown (with agent: which agent's limits the Usage screen lists)/usage_order (the agents were arranged); phones: push/live_activities), on |
host_update_installed |
host | installHostUpdate |
— |
network_joined |
host | networkCreate / networkJoin: the computer is in a network of the user's computers |
via (create/invite), never a name, invite or connector address |
network_changed |
host | networkInvite / networkPromote / networkRemove / networkRecover / setNetworkRules / networkLeave |
action (invite/promote/remove/recover/rules/leave), never a computer's name, the invite, the recovery code or a rule |
network_failed |
host | A network step failed: a saved network didn't start with the host, a bot's letter to another computer didn't go (refused, or no such computer; one queued for a computer that's away isn't a failure), a request's outcome didn't go back, a letter from another computer couldn't be taken in, or a network* call failed |
stage (start/send/reply/receive/action); for action, the call's own via or action as on network_joined / network_changed; never the error's text, a name or an address |
Screens
screen_viewed names one screen per value, the same on every client that has it:
screen |
iOS / Android | Desktop | Terminal UI |
|---|---|---|---|
bots |
Bots tab | — (always shown) | — |
state |
State tab | — | — |
chat |
a conversation opened | a conversation opened | a conversation opened |
trace |
full conversation | full conversation | full trace |
bot_details |
bot details | details panel | settings page |
memory |
bot memory (Android: the Memory tab in bot details) | memory tab | memory overlay |
routines |
routines (iPhone: a routine's editor, the list being part of bot details) | a routine's editor | routines overlay |
marketplace |
extensions | extensions | marketplace overlay |
settings |
Settings tab | settings | — |
computers |
Computer management, from Manage computers or a link | computers & devices | — |
usage |
usage | usage | usage overlay |
account |
account sheet | account panel | — |
pairing |
pair a computer after setup (first run: onboarding_step_viewed) |
pair a phone | pair overlay |
voice_settings |
voice chat settings | voice chat settings | — |
remote_screen |
remote screen | — | — |
computer_access |
— | computer access | — |
help |
— | — | keys overlay |
library |
a chat's Library (iPhone: the details tab; Android: its sheet) | library tab | library overlay |
artifact |
an artifact's viewer | an artifact's viewer | — (opens in the browser) |
network |
network sheet (Network on a computer's card in Manage computers) | — (part of computers) |
network sheet |
Funnels
The Onboarding & conversion dashboard in PostHog reads these steps, each per $os:
- Desktop: first
app_opened(orhost_setup_failed) →sign_in_started→signed_in→onboarding_completed→computer_access_finished→pairing_code_created→device_paired→message_sentwithclient = remote(Activated). - iPhone / Android: first
onboarding_step_viewedwelcome→sign_in_started→signed_in→install→scan→computer_paired→message_sentwithclient = remoteon thatcomputer; an account with computers goeschoose→access_requested→computer_paired(via = account), orchoose→install. The sign-in steps are the welcome screen's sign-in rate (required 2.35.0 to 2.40.x);continued_without_accounttakes the other way from 2.41.0. - Star:
star_prompt_answeredwithstarred÷ allstar_prompt_answered, perask. - Website:
$pageview→download_clicked(perplatform) → the firstapp_openedthat day (counts only, no link between a visitor and an install).
Website
codync.dev counts visits without cookies or anything stored on the visitor's device
(posthog-js cookieless_mode: 'always', which needs the project's cookieless server hash mode;
without it PostHog drops these events): $pageview, $pageleave (time on page and scroll depth), $web_vitals (load speed, without attribution), download_clicked (platform:
mac/windows/linux/ios; linux counts the Linux download links (x86_64 and arm64) and copies of the install command; the Homebrew mac is a copy of its command),
link_opened (link: issues, github, discord, lark, product_hunt, ko_fi, demo, android_test, which is the Google Play button that opens the Android tester sign-up form, and lark_qr / wechat_qr, the QR code downloads on the China community page). One document-level click listener in web/app/analytics.tsx matches each
link's href against its links table, so a new link needs a row there to be counted; the film counts as demo when focus moves
into its frame. Events go through the site's own /e path, which web/vercel.json rewrites to
PostHog, so content blockers don't drop them; only Vercel has the rewrite, so next dev on a LAN
address sends nothing that arrives.
Store review invitations (iPhone App Store, Android Google Play)
These events use the existing phone sender, identity, environment, version and analytics
opt-out. Android sends only review_link_opened until it has the invitation. No conversation content, message nonce, bot ID or review text is included.
| Event | When | Properties |
|---|---|---|
review_requested |
The persisted cooldown is consumed and StoreKit is about to be called | prompts (count), policy: v2 |
review_link_opened |
The person taps Rate on the App Store (Android: Rate on Google Play) in Settings | source: settings |
review_requested does not mean the system displayed a prompt or the person submitted a
rating. Neither StoreKit nor Google Play provides those outcomes. The invitation policy
describes timing, exclusions, and cooldowns.
Both phones also report link_opened with link: issues for their independent Report an issue action, and link: app_store for Update Codync (Android opens Google Play).