Match the first-party mobile client's connection screen: - the first screen lists saved servers, the one last used leading with its connect button or connected state, the others below, and adding is one tap - servers can be added, edited (name, address, proxy, self-signed) and deleted; deleting the live or last one returns to the list - a password sheet prompts only when the server asks for one, keeps the error and the typed password for a retry - while connected, the instances sheet switches servers - proxy and self-signed options stay per server (the native app's own) - the single-server record and its token migrate automatically - permission cards read a plain signal, fixing a flaky update - bump version to 0.1.2 (build 3)
OpenChamber Native
A lightweight OpenChamber client for phones, written in Go with Asuka's native widgets. Android first.
Status: M0–M4 done — multiple saved servers with a connect list (add, edit, delete, switch; password prompt; HTTP or SOCKS5 proxy and self-signed certificates per server), live session list, chat with streaming Markdown, permissions, model/agent switching, new sessions, archive/delete/rename, and a UI-independent API client.
What is here
| Path | What |
|---|---|
internal/ocapi/ |
OpenChamber HTTP client: auth (password → device token), sessions, messages, prompt/interrupt/model/agent, permissions, SSE events, HTTP/SOCKS5 proxy, certificate pinning |
internal/storage/ |
Saved servers in asuka/sdk/store, one device token per server in asuka/sdk/secure (Android Keystore), per-install id for device dedupe, migration from the single-server record |
internal/appui/ |
Screens: connect, sessions, chat (streaming Markdown, reasoning/tool folding, permissions) |
cmd/ocprobe/ |
Terminal probe used to validate the API without a device |
PLAN.md |
Research, API contract, architecture, milestones, risks |
Run
# terminal probe against a running server
go run ./cmd/ocprobe -url http://127.0.0.1:3000 health
go run ./cmd/ocprobe -url http://127.0.0.1:3000 -limit 5 sessions
go run ./cmd/ocprobe -url http://127.0.0.1:3000 -password secret sessions
go run ./cmd/ocprobe -url http://127.0.0.1:3000 -seconds 20 events
# the app on this computer (browser / GTK window)
asuka dev --platform web
asuka dev
# headless tests, including the UI
go test ./... -race
asuka must be installed from main; the v0.1.1 release does not build on
Linux:
go install github.com/egoist/asuka/cmd/asuka@main
Android
The SDK lives at ~/SDK/AndroidSDK, the JDKs at ~/SDK/jdk-21 (Gradle) and
~/SDK/jdk-17 (the Android toolchain; registered in
~/.gradle/gradle.properties via org.gradle.java.installations.paths).
export ANDROID_HOME=$HOME/SDK/AndroidSDK
export JAVA_HOME=$HOME/SDK/jdk-21
export PATH=$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$JAVA_HOME/bin:$PATH
asuka dev --platform android --device emulator-5554 # hot reload
asuka dev --platform android --once --no-vet # build in, launch once
# release: a keystore is required
export ASUKA_KEYSTORE=$HOME/SDK/test-upload.jks ASUKA_KEY_ALIAS=upload
export ASUKA_KEYSTORE_PASSWORD=… ASUKA_KEY_PASSWORD=…
asuka build --platform android # dist/OpenChamber.aab
netcfg/ is a native module whose only job is the Android manifest: it merges
android:usesCleartextTraffic="true" into release builds too, because
self-hosted OpenChamber servers are often plain HTTP on a LAN. Asuka enables it
for debug only. Delete the package (and its blank import in main.go) to
require HTTPS everywhere.
Proxies are entered as http://host:port or socks5://host:port
(no proxy authentication). Plain http:// works in debug builds; the release
cleartext policy is decided in M5 (see PLAN.md).