feat(web-tui): add experimental browser-hosted TUI

.github/workflows/release.yml

@@ -64,9 +64,54 @@ jobs:
           path: kit_*.tar.gz
           if-no-files-found: error
 
+  browser-tui:
+    name: Browser TUI / ${{ matrix.os }} / ${{ matrix.browser }}
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 25
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            browser: chromium
+          - os: ubuntu-latest
+            browser: firefox
+          - os: macos-15
+            browser: webkit
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        working-directory: app
+        run: bun install --frozen-lockfile
+
+      - name: Install browser
+        working-directory: app
+        run: bunx playwright install --with-deps ${{ matrix.browser }}
+
+      - name: Build binary
+        working-directory: app
+        run: bun run build
+
+      - name: Test browser TUI
+        working-directory: app
+        run: bunx playwright test --project=${{ matrix.browser }}
+
+      - name: Upload browser artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-web-tui-${{ matrix.os }}-${{ matrix.browser }}-results
+          path: app/test-results/web-tui
+          if-no-files-found: ignore
+
   release:
     name: Create GitHub release
-    needs: build
+    needs: [build, browser-tui]
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

.github/workflows/web-tui-browser.yml

@@ -0,0 +1,66 @@
+name: Browser TUI smoke
+
+on:
+  pull_request:
+    paths:
+      - "app/**"
+      - ".github/workflows/web-tui-browser.yml"
+  push:
+    branches: [main]
+    paths:
+      - "app/**"
+      - ".github/workflows/web-tui-browser.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: web-tui-browser-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  browser:
+    name: ${{ matrix.os }} / ${{ matrix.browser }}
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 25
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            browser: chromium
+          - os: ubuntu-latest
+            browser: firefox
+          - os: macos-15
+            browser: webkit
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        working-directory: app
+        run: bun install --frozen-lockfile
+
+      - name: Install browser
+        working-directory: app
+        run: bunx playwright install --with-deps ${{ matrix.browser }}
+
+      - name: Build binary
+        working-directory: app
+        run: bun run build
+
+      - name: Test browser TUI
+        working-directory: app
+        run: bunx playwright test --project=${{ matrix.browser }}
+
+      - name: Upload browser artifacts
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: web-tui-${{ matrix.os }}-${{ matrix.browser }}-results
+          path: app/test-results/web-tui
+          if-no-files-found: ignore

.gitignore

@@ -1,5 +1,7 @@
 node_modules/
 .dist/
 dist/
+test-results/
+playwright-report/
 .DS_Store
 keymap-keybindings-progress.local.md

README.md

@@ -37,8 +37,10 @@ kit -p --model openai/gpt-5.5 "review this" # selects an exact provider/model
 kit -p --session abc123 "continue this" # continues and persists a specific session
 kit --rpc            # runs as a headless JSONL subprocess
 kit --rpc --no-session # runs the RPC conversation in memory
-kit --web            # serves the current directory's latest session in the browser
+kit --web            # serves the current directory's latest session in the semantic browser UI
 kit --web --no-session # serves an in-memory browser session
+kit --web-tui        # serves the real interactive TUI in a desktop browser (experimental)
+kit --web-tui --model openai/gpt-5.5 # starts the browser TUI with an exact provider/model
 kit -s abc123        # opens a specific session by ID (long or short id)
 kit threads          # launches a session picker
 ```

app/biome.json

@@ -1,7 +1,13 @@
 {
 	"$schema": "https://biomejs.dev/schemas/2.3.14/schema.json",
 	"files": {
-		"includes": ["**", "!!**/dist", "!!**/vendor"]
+		"includes": [
+			"**",
+			"!!**/dist",
+			"!!**/vendor",
+			"!!**/test-results",
+			"!!**/playwright-report"
+		]
 	},
 	"linter": {
 		"enabled": true,