From e79eaf43aa48476aebef6795eccc3f24cff5cf23 Mon Sep 17 00:00:00 2001
From: Gabriel Brown <gib@gibbyb.com>
Date: Sun, 1 Nov 2026 01:45:04 -0500
Subject: [PATCH] Start WristCode: README, license, layout

---
 .gitignore | 13 +++++++++++++
 LICENSE    | 21 +++++++++++++++++++++
 README.md  | 42 ++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 76 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 LICENSE
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..bfbe491
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,13 @@
+node_modules/
+.env
+.env.*
+!.env.example
+*.sqlite
+*.sqlite-*
+.DS_Store
+# Xcode
+watch/*.xcodeproj/
+xcuserdata/
+DerivedData/
+build/
+*.p8
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..56e9e77
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gabriel Brown
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a751797
--- /dev/null
+++ b/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