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: describe min-version compatibility instead of major versions

leepokai22018eede562
diff --git a/README.md b/README.md
index 8c82431e..0b612ab4 100644
--- a/README.md
+++ b/README.md
@@ -221,7 +221,7 @@ For release-by-release changes, see [GitHub Releases](https://github.com/leepoka
## Versioning
-The major version is the phone ↔ host protocol: apps work with hosts of the same major version.
+Clients and the host each name the oldest version of the other they still work with (`minApp` in the host's `hello`, `minHost` in each client), so an app can meet an older or newer host. Details: [compatibility](docs/reference/compatibility.md).
## License
diff --git a/docs/architecture/overview.md b/docs/architecture/overview.md
index f3e3da1e..fa739e62 100644
--- a/docs/architecture/overview.md
+++ b/docs/architecture/overview.md
@@ -62,6 +62,6 @@ Remote screen uses the channel for signaling and WebRTC for media/input. Cloudfl
## Release and environment boundaries
-Application/host major versions must match. The channel wire version (`v=1`), pairing URL version (`v=3`) and the cloud health endpoint's service version are separate values.
+Client/host compatibility uses mutual minimum versions (`minApp` / `minHost`, see [compatibility](../reference/compatibility.md)). The channel wire version (`v=1`), pairing URL version (`v=3`) and the cloud health endpoint's service version are separate values.
Debug iOS builds use `apps/shared/Config/dev.plist`; Release uses `main.plist`. The desktop app takes the same values through `apps/desktop/tools/account-config.mjs`. The host compiles in its cloud from `CODYNC_ENV` (`main`, else dev), set by the same packaging script (`dist:mac:dev` / `dist:mac:main`). Production fields are currently incomplete in checked-in configuration, so a successful Debug install is not production readiness. See [environments](../guides/environments-and-deployment.md).
diff --git a/docs/guides/cloudflare-testing.md b/docs/guides/cloudflare-testing.md
index c03cc7aa..2784a4fc 100644
--- a/docs/guides/cloudflare-testing.md
+++ b/docs/guides/cloudflare-testing.md
@@ -4,7 +4,7 @@ The remote channel, account approval and relay implementation exist. You can beg
## Prerequisites
-- Run matching app/host major versions and replace old running processes after installation ([development](development.md)).
+- Run app/host versions within each other's `minApp` / `minHost` floors ([compatibility](../reference/compatibility.md)) and replace old running processes after installation ([development](development.md)).
- Point both app and host at the intended cloud. Debug app configuration uses `https://dev-api.codync.dev`; check `codync-host cloud` on the computer. Enable/configure it through **Reach from anywhere** or the CLI when needed.
- Keep the computer awake, online, and its host running. Ensure the selected agent works locally first.
- Pair through a fresh QR, or sign in and approve device access by comparing the six-digit code on the computer. A Google login alone does not authorize access.
diff --git a/docs/reference/remote-relay.md b/docs/reference/remote-relay.md
index 61f8479c..e3ccf1c7 100644
--- a/docs/reference/remote-relay.md
+++ b/docs/reference/remote-relay.md
@@ -64,7 +64,7 @@ Shared deterministic [vectors](fixtures/remote-relay-vectors.json) and their [ge
| iOS account integration | `apps/shared/AccountSession.swift` |
| Desktop account, device key, cloud API | `apps/desktop/src/main/account.ts`, `cloud.ts` |
-See [architecture](../architecture/overview.md) and [file structure](../architecture/file-structure.md). Application/host compatibility follows their major version; channel `v`, QR version and Worker package version are separate values.
+See [architecture](../architecture/overview.md) and [file structure](../architecture/file-structure.md). Application/host compatibility follows mutual minimum versions ([compatibility](compatibility.md)); channel `v`, QR version and Worker package version are separate values.
## 3. 身分與金鑰