Start WristCode: README, license, layout

README.md

@@ -0,0 +1,42 @@
+# WristCode
+
+An Apple Watch client for [T3 Code](https://t3.codes). Browse threads across every T3 Code
+environment you run, reply by dictation, start new threads, and get a notification when an agent
+finishes. It works over the watch's own cellular connection, with no phone nearby.
+
+Early work in progress.
+
+## How it fits together
+
+watchOS only allows WebSockets for audio streaming apps, and T3 Code clients talk to their server
+over a WebSocket. So the watch talks HTTPS to a small gateway, and the gateway talks to each T3 Code
+server.
+
+```
+Apple Watch  --HTTPS-->  gateway  --WebSocket-->  T3 Code server (one per environment)
+                            |
+                            +--APNs-->  notifications on the watch
+```
+
+- `gateway/` is the gateway: Bun and TypeScript, shipped as a container image.
+- `watch/` is the watchOS app: SwiftUI, watch only, no iPhone companion.
+- `docs/` holds the design notes and the T3 Code protocol reference.
+- `mocks/` holds static UI mocks of the watch screens.
+
+## Auth
+
+The gateway signs in to each T3 Code server with a scoped bearer session, limited to reading and
+driving threads:
+
+```sh
+t3 auth session issue \
+  --scope orchestration:read --scope orchestration:operate \
+  --ttl 30d --label "WristCode gateway" --token-only
+```
+
+The watch pairs with the gateway once by entering a short code, and keeps the device token it gets
+back in its Keychain.
+
+## License
+
+MIT