Improve OpenChamber responsiveness under large session workloads while fixing cache, synchronization, and persistence correctness across runtimes, projects, directories, and worktrees. - prioritize selected and visible sessions during bootstrap and defer non-critical enrichment work - reduce redundant message loading, event processing, store publication, and hidden sidebar work - prevent stale session and message requests from overwriting newer authoritative state - preserve existing data when authoritative fetches fail instead of treating failures as successful empty responses - scope session materialization, messages, drafts, queues, todos, pins, permissions, folders, tabs, Git state, and pull request data by runtime and directory identity - harden runtime switching, reconnect, cleanup, mutation reconciliation, and persisted-state ordering - preserve live subagent Task linkage when metadata arrives after an older message request or while streaming parts are suspended - coalesce overlapping tail refreshes without losing newer refresh demand - improve cold-session loading by moving deferrable work out of the critical bootstrap path - isolate URL authentication, mobile credentials, native secrets, and other runtime-owned state across endpoint changes - bound long-lived caches and remove avoidable allocations from event and rendering hot paths - limit virtualization to archive collections where it improves rendering without disrupting active sidebar layout - stabilize session folders, pin ordering, expanded state, and persisted sidebar behavior - open skill files through the same secure editor and outside-workspace grant flow used by file navigation, including worktree sessions - expand regression coverage for stale completions, runtime collisions, reconnect behavior, persistence races, authoritative empty results, and subagent refresh ordering - document the updated synchronization, cache ownership, performance, and runtime-isolation invariants
OpenChamber Mobile
Capacitor shell for the dedicated OpenChamber mobile web surface.
The mobile package reuses the web build, then rewrites mobile.html to index.html in packages/mobile/dist so native iOS/Android always launch MobileApp instead of the hosted surface selector.
Runtime Model
- The native app bundles the mobile UI only; it does not embed the OpenChamber web server or OpenCode server.
- On first launch in Capacitor, the app shows a connection screen for an existing OpenChamber server.
- Connections are saved locally in the app and can be managed from the mobile overflow menu under
Instances. - The connection screen and
Instancesmenu item are Capacitor-only. Hostedmobile.htmlin a normal browser keeps the regular web behavior. - Password-protected OpenChamber servers can be unlocked from the mobile app. The app stores the issued client token with the saved connection.
- The Terminal workspace surface runs its PTY on the active OpenChamber server over the shared authenticated runtime transport; it never opens a local shell on the phone or tablet. Closing the surface detaches the renderer while the server session remains available for reattachment. On touch devices, dragging scrolls the buffer while long-pressing and dragging selects terminal text.
Commands
Run these from packages/mobile, or use the root mobile:* aliases.
bun run build: buildspackages/weband prepares mobile web assets.bun run build:assets: prepares mobile assets from an existingpackages/web/distbuild; the root workspace build uses this to avoid rebuilding web.bun run sync: prepares assets and runscap sync.bun run add:ios: creates the native iOS project.bun run add:android: creates the native Android project.bun run build:android:debug: builds a debug Android APK without launching an emulator.bun run build:ios:simulator: builds an iOS Simulator app without launching Xcode or Simulator.bun run sim:run: boots a simulator if needed, installs the built iOS app, and launches it.bun run sim:serve: startsserve-simin detached JSON mode and prints the browser preview URL.bun run sim:list: lists runningserve-simstreams.bun run sim:kill: stops runningserve-simstreams.bun run open:ios: opens the iOS project.bun run open:android: opens the Android project.
Headless Quickstart
bun run build
bun run sync
bun run build:ios:simulator
bun run build:android:debug
These commands build and sync the native projects without launching Xcode, Android Studio, Simulator, or an emulator.
Local Tooling
The default scripts assume the local Homebrew/Xcode paths prepared for this workspace:
- Xcode:
/Applications/Xcode.app/Contents/Developer - JDK 21:
/opt/homebrew/opt/openjdk@21 - Android SDK:
/opt/homebrew/share/android-commandlinetools
Override DEVELOPER_DIR, JAVA_HOME, ANDROID_HOME, or ANDROID_SDK_ROOT when using a different local setup.
Required local tools:
- Xcode with iOS Simulator support.
- CocoaPods for iOS dependency installation.
- JDK 21 for Android Gradle builds.
- Android SDK command-line tools with platform/build-tools 35.
Troubleshooting
- If
xcodebuildreports that the active developer directory is Command Line Tools, keep using the provided scripts or setDEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer. - If Android builds fail with
Unable to locate a Java Runtimeorsource release: 21, install/use JDK 21 and setJAVA_HOMEaccordingly. - If Android SDK packages are missing, install
platform-tools,platforms;android-35, andbuild-tools;35.0.0, then accept SDK licenses. - If CocoaPods cannot find Capacitor pods after reinstalling dependencies, run
bun installfrom the workspace root, then rerunbun run sync. - If connecting to a remote OpenChamber server fails from the app while
/healthworks in curl, check that the server build includes the packaged-client CORS allowlist forcapacitor://localhostand local dev origins. - If
serve-simpreview says the stream is not producing frames, check the raw MJPEG stream before assuming the simulator stopped. In prior testing the raw stream worked while the browser preview UI stayed stale.
Generated Assets
The native projects currently use Capacitor-generated launcher and splash assets. Replace them before release branding work.