mewla docs

Zen v0.1.13#

This release contains the reviewed changes on main since v0.1.12.

Highlights since v0.1.12#

  • Plugins and Skills management now show the current server, clearer account and inventory states, and focused actions. The navigation drawer groups destinations, labels Model Providers consistently, and honors reduced motion and cancelled drag gestures.
  • Persistent Browser resources support reusable server-owned profiles and managed Codex/Claude session attachment. New browsers are shared with same-server Agents by default, with one input owner and explicit takeover. The Browser navigation entry is temporarily hidden; its route and server resources remain available.
  • Plugins now provides service-first onboarding with official browser authorization, reviewed read/write capability groups, and server-owned connected accounts for Brain and Workers. Custom MCP and OpenAPI services retain explicit endpoint, network-trust, and tool-permission boundaries.
  • Native authorization returns remain bound to the original server across server switches. Resume, cancellation, and retry states are clearer, and older native clients can open the official authorization page without crashing on an unavailable browser module.
  • GitHub device authorization preserves expiring access tokens and rotating refresh tokens. Daemon builds consume reviewed public publisher metadata; provider registration and real account consent remain separate prerequisites.
  • Brain recovers missing host sessions throughout the daemon lifetime using host-removal events. Cursor worker detection uses the executable identity so selecting a Claude model does not misclassify the worker.
  • Brain now routes each Worker from its maintained routing.md, while the Brain and Worker prompts shed retired defaults and keep design, frontend, and copy work with the intended owner. Context injection is shorter and more focused.
  • The README and public site now explain Zen around one owner running many agents, with the static homepage published through GitHub Pages and its SVG generators kept reproducible.
  • Remote Desk and its dedicated Android/iOS and daemon runtimes have been retired, including obsolete desktop pairing guidance.

Known limitations#

  • Persistent Browser remains a candidate capability. Its current runtime adapter requires Linux, installed Chrome/Chromium and agent-browser, and an already unlocked Secret Service wallet. Remote page pixels do not include native browser chrome or device-bound passkeys; Google/MFA acceptance and protection from unrestricted same-UID shells are not established. Existing Agent attachments are not restored after a daemon restart.
  • First-time built-in connections depend on each provider's publisher readiness and the user's real account consent. Protocol tests, public-client build wiring, and successful discovery do not prove a live provider grant. Slack/Google publisher provisioning remains incomplete; Linear/Notion account consent and granted operations remain unverified.
  • iOS Preview delivery requires successful exact-tag archive/export, App Store Connect upload and processing, and Apple's Beta App Review. The previous v0.1.12 upload was rejected with an App Store Connect agreement HTTP 403; the new release must establish its own outcome before claiming TestFlight availability.
  • Android is distributed as a signed arm64 APK without a Play Store package; installation may require allowing unknown sources.

What changed#

  • Recover Brain host sessions throughout daemon lifetime (6d25346)
  • Recover Brain on host removal events instead of heartbeat polling (8c25cc1)
  • Add server-owned plugins for Brain and Workers (23cb334)
  • Add browser OAuth and trusted internal plugin endpoints (a584c37)
  • Merge branch 'main' into feat/connections (1142298)
  • Preserve MCP resource binding during token refresh (b70af4e)
  • Rebuild plugin onboarding with native authorization and capability consent (765a451)
  • Remove Remote Desk and its dedicated runtimes (cc05fc0)
  • Integrate Plugins onboarding with Remote Desk retirement (8d9a633)
  • Preserve native authorization returns across server switches (1d5a2dd)
  • Integrate committed Remote Desk retirement with Plugins verification (a46bfb4)
  • Remove obsolete desktop pairing guidance (486b4f2)
  • Keep connection cancellation clear after app resume (896fcaf)
  • Fix plugin keyboard focus and document Notion discovery (03e82c1)
  • Wire public plugin clients into daemon builds (2ad432e)
  • Refresh expiring GitHub device authorizations (adb5850)
  • Keep plugin authorization usable on older native clients (1671c61)
  • Detect Cursor workers by executable instead of model (deee79a)
  • Fix stable release CI gates (c2dc1be)
  • Document v0.1.13 reviewed release context (cf5da92)
  • Stabilize native boundary and sampler tests (7b8a8f0)
  • Record GitHub publisher release blocker (218f28f)
  • Verify native Claude usage in Stats (faadf70)
  • Own primary drawer state on the UI thread (e45cb7d)
  • Regroup drawer menu and rename Model Providers (082c44c)
  • Honor reduced motion and cancelled drawer drags (37bb0d4)
  • Add persistent Browser resources and managed session attachment (a9fb3bb)
  • Align headed Browser frames with input coordinates (6da4388)
  • Redesign Plugins and Skills management pages (8a47493)
  • Redesign Browser page around reusable sign-ins and readable recovery (2dbd639)
  • Open the default Browser directly and share it with same-server Agents (e02bc01)
  • Trim explanatory copy on Browser, Plugins and Skills (45bbb87)
  • Clarify when a preselected Browser is sent with a session (f08d226)
  • Share new Browsers with same-server Agents by default (b0de5a3)
  • Hide Browser from the navigation drawer (aac0494)
  • Merge remote-tracking branch 'origin/main' into release/recheck-0.1.13 (e50ea4e)
  • Update v0.1.13 Browser and management highlights (0d7f55e)
  • Align Browser with route and icon contracts (9a0658d)
  • Isolate Browser transport mocks from upload tests (001fdab)
  • Slim Brain workspace and context (40850be)
  • brain: list open Work without objectives by default (3ff029b)
  • brain: supersede unreviewed machine resource pressure Work (490666c)
  • brain: raise signal-to-noise of injected Host and Worker prompts (bbbb332)
  • brain: reword prompts for frontier models and fold align, calendar into owners (a7fc226)
  • brain: route each Worker from a Brain-maintained routing.md (9a7513c)
  • app: drop Worker executor target from the executor sheet (a311fda)
  • site: describe routing.md instead of set-delegated (247e6ef)
  • brain: drop retired Worker defaults from the role contract (daf8fb7)
  • brain: route design, frontend and copy to claude in the routing seed (945c4d2)
  • site, readme: redesign around one owner running many agents (5997eb4)
  • site: keep SVG generators and match the done notification (0289947)
  • Publish homepage with GitHub Pages (d2fc27c)
  • Configure GitHub publisher client (9a8988c)

Install#

Download zen-linux-amd64.tar.gz, zen-linux-arm64.tar.gz, or zen-darwin-arm64.tar.gz for your host, plus the Android APK and SHA256SUMS. Extract the archive, install zen on your PATH, run zen, then create a pairing link with zen pair https://your-origin.

Apple Silicon support requires tmux (brew install tmux). The macOS binary is cross-built; validate it on a real Apple Silicon host before operational use.

The iOS Preview is distributed through TestFlight at https://testflight.apple.com/join/rTKCDzMt, subject to Apple's beta approval and processing.

iOS Preview identity#

  • Bundle: com.daoleno.zen.preview
  • Marketing version: 0.1.13
  • TestFlight build: 35
  • Source tag: v0.1.13

The iOS build number is tracked independently from Android because App Store Connect build history can be ahead.

Android identity#

  • Package: com.daoleno.zen
  • versionCode: 37
  • ABI: arm64-v8a
  • Signing certificate SHA-256: C2:FC:5B:09:B3:86:92:EE:70:59:71:1F:E7:ED:B8:79:4C:E3:65:FE:1C:7A:06:AB:95:4E:5D:D1:BD:CD:A4:FD

Android may require permission to install from unknown sources or display a Play Protect warning. Obtainium can follow this repository's GitHub Releases. Zen does not currently provide a Play Store package; iOS Preview distribution uses TestFlight.