Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
renames
Theo Browne5120f7fec702
diff --git a/AGENTS.md b/AGENTS.mdindex 8edd09be9..7f5148fce 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -14,7 +14,7 @@ If a tradeoff is required, choose correctness and robustness over short-term con## Package Roles- `apps/server`: Node.js WebSocket server. Wraps Codex app-server (JSON-RPC over stdio), serves the React web app, and manages provider sessions.-- `apps/renderer`: React/Vite UI. Owns session UX, conversation/event rendering, and client-side state. Connects to the server via WebSocket.+- `apps/web`: React/Vite UI. Owns session UX, conversation/event rendering, and client-side state. Connects to the server via WebSocket.- `packages/contracts`: Shared Zod schemas and TypeScript contracts for provider events, WebSocket protocol, and model/session types.## Codex App Server (Important)@@ -24,7 +24,7 @@ How we use it in this codebase:- Session startup/resume and turn lifecycle are brokered in `apps/server/src/codexAppServerManager.ts`.- Provider dispatch and thread event logging are coordinated in `apps/server/src/providerManager.ts`.- WebSocket server routes NativeApi methods in `apps/server/src/wsServer.ts`.-- Renderer consumes provider event streams via WebSocket push on channel `providers.event`.+- Web app consumes provider event streams via WebSocket push on channel `providers.event`.Docs:- Codex App Server docs: https://developers.openai.com/codex/sdk/#app-serverdiff --git a/README.md b/README.mdindex 6f90c7ad7..1f18c9d30 100644--- a/README.md+++ b/README.md@@ -29,9 +29,9 @@ T3 Code runs as a **Node.js WebSocket server** that wraps `codex app-server` (JS## Workspace layout-- `/apps/server`: Node.js WebSocket server. Wraps Codex app-server, serves the built renderer, and opens the browser on start.-- `/apps/renderer`: React + Vite UI. Session control, conversation, and provider event rendering. Connects to the server via WebSocket.-- `/apps/desktop`: Electron shell. Spawns a desktop-scoped `t3` backend process and loads the shared renderer.+- `/apps/server`: Node.js WebSocket server. Wraps Codex app-server, serves the built web app, and opens the browser on start.+- `/apps/web`: React + Vite UI. Session control, conversation, and provider event rendering. Connects to the server via WebSocket.+- `/apps/desktop`: Electron shell. Spawns a desktop-scoped `t3` backend process and loads the shared web app.- `/packages/contracts`: Shared Zod schemas and TypeScript contracts for provider events, WebSocket protocol, and model/session types.## Codex prerequisites@@ -61,9 +61,9 @@ npx t3- `bun run dev` — Starts contracts, server, and web dev tasks via Turborepo's parallel task runner.- `bun run dev:server` — Starts just the WebSocket server (uses tsx for TS execution).-- `bun run dev:web` — Starts just the Vite dev server for the renderer.-- `bun run start` — Runs the production server (serves built renderer as static files).-- `bun run build` — Builds contracts, renderer, and server through Turbo.+- `bun run dev:web` — Starts just the Vite dev server for the web app.+- `bun run start` — Runs the production server (serves built web app as static files).+- `bun run build` — Builds contracts, web app, and server through Turbo.- `bun run typecheck` — Strict TypeScript checks for all packages.- `bun run test` — Runs workspace tests.@@ -76,7 +76,7 @@ T3 Code has a global runtime mode switch in the chat toolbar:## Provider architecture-The renderer communicates with the server via WebSocket using a simple JSON-RPC-style protocol:+The web app communicates with the server via WebSocket using a simple JSON-RPC-style protocol:- **Request/Response**: `{ id, method, params }` → `{ id, result }` or `{ id, error }`- **Push events**: `{ type: "push", channel, data }` for streaming provider eventsdiff --git a/apps/desktop/package.json b/apps/desktop/package.jsonindex 7cfe51371..9fc5d44ac 100644--- a/apps/desktop/package.json+++ b/apps/desktop/package.json@@ -4,7 +4,7 @@"private": true,"main": "dist-electron/main.js","scripts": {- "dev": "bun run --cwd ../server build && concurrently -k -n BUNDLE,RENDERER,ELECTRON \"bun run dev:bundle\" \"bun run --cwd ../renderer dev\" \"bun run dev:electron\"",+ "dev": "bun run --cwd ../server build && concurrently -k -n BUNDLE,WEB,ELECTRON \"bun run dev:bundle\" \"bun run --cwd ../web dev\" \"bun run dev:electron\"","dev:bundle": "tsup --watch","dev:electron": "bun run scripts/dev-electron.mjs","build": "tsup",diff --git a/apps/desktop/scripts/smoke-test.mjs b/apps/desktop/scripts/smoke-test.mjsindex cc13d4693..895d18b8b 100644--- a/apps/desktop/scripts/smoke-test.mjs+++ b/apps/desktop/scripts/smoke-test.mjs@@ -8,7 +8,7 @@ const rootDir = resolve(__dirname, "../../..");const electronBin = resolve(desktopDir, "node_modules/.bin/electron");const mainJs = resolve(desktopDir, "dist-electron/main.js");-console.log("Building contracts + renderer + server + desktop...");+console.log("Building contracts + web + server + desktop...");execSync("bun run build", { cwd: rootDir, stdio: "inherit" });console.log("\nLaunching Electron smoke test...");diff --git a/apps/desktop/src/main.ts b/apps/desktop/src/main.tsindex 3cc451911..3161a2e9d 100644--- a/apps/desktop/src/main.ts+++ b/apps/desktop/src/main.ts@@ -14,7 +14,7 @@ fixPath();const PICK_FOLDER_CHANNEL = "desktop:pick-folder";const ROOT_DIR = path.resolve(__dirname, "../../..");const BACKEND_ENTRY = path.join(ROOT_DIR, "apps/server/dist/index.js");-const RENDERER_ENTRY = path.join(ROOT_DIR, "apps/renderer/dist/index.html");+const WEB_ENTRY = path.join(ROOT_DIR, "apps/web/dist/index.html");const STATE_DIR = path.join(os.homedir(), ".t3", "userdata");const isDevelopment = Boolean(process.env.VITE_DEV_SERVER_URL);@@ -167,10 +167,10 @@ function createWindow(): BrowserWindow {if (isDevelopment) {void window.loadURL(process.env.VITE_DEV_SERVER_URL as string);} else {- if (!fs.existsSync(RENDERER_ENTRY)) {- throw new Error(`Renderer bundle missing at ${RENDERER_ENTRY}`);+ if (!fs.existsSync(WEB_ENTRY)) {+ throw new Error(`Web bundle missing at ${WEB_ENTRY}`);}- void window.loadFile(RENDERER_ENTRY);+ void window.loadFile(WEB_ENTRY);}window.on("closed", () => {diff --git a/apps/server/package.json b/apps/server/package.jsonindex 267fdd354..d9b3af34a 100644--- a/apps/server/package.json+++ b/apps/server/package.json@@ -24,7 +24,7 @@},"devDependencies": {"@t3tools/contracts": "workspace:*",- "@t3tools/renderer": "workspace:*",+ "@t3tools/web": "workspace:*","@types/node": "^22.10.2","@types/ws": "^8.5.13","tsup": "^8.3.5",diff --git a/apps/server/scripts/bundle-client.mjs b/apps/server/scripts/bundle-client.mjsindex d26a74f0b..33b44cd5e 100644--- a/apps/server/scripts/bundle-client.mjs+++ b/apps/server/scripts/bundle-client.mjs@@ -1,5 +1,5 @@/**- * Copies the built renderer into dist/client/ so the published npm package+ * Copies the built web app into dist/client/ so the published npm package* includes the web UI. This runs as a post-build step.*/import fs from "node:fs";@@ -7,15 +7,15 @@ import path from "node:path";import { fileURLToPath } from "node:url";const __dirname = path.dirname(fileURLToPath(import.meta.url));-const rendererDist = path.resolve(__dirname, "../../renderer/dist");+const webDist = path.resolve(__dirname, "../../web/dist");const target = path.resolve(__dirname, "../dist/client");-if (!fs.existsSync(rendererDist)) {+if (!fs.existsSync(webDist)) {console.log(- "⚠ Renderer dist not found — skipping client bundle. Run `bun run --cwd apps/renderer build` first.",+ "⚠ Web dist not found — skipping client bundle. Run `bun run --cwd apps/web build` first.",);process.exit(0);}-fs.cpSync(rendererDist, target, { recursive: true });-console.log("✓ Bundled renderer into dist/client");+fs.cpSync(webDist, target, { recursive: true });+console.log("✓ Bundled web app into dist/client");diff --git a/apps/server/src/index.ts b/apps/server/src/index.tsindex 97e2c5bcc..d34065760 100644--- a/apps/server/src/index.ts+++ b/apps/server/src/index.ts@@ -84,8 +84,8 @@ function resolveStaticDir(): string | undefined {// Not bundled — check monorepo layout}- // Monorepo layout: apps/server/dist/index.js → apps/renderer/dist/- const monorepoClient = path.resolve(__dirname, "../../renderer/dist");+ // Monorepo layout: apps/server/dist/index.js → apps/web/dist/+ const monorepoClient = path.resolve(__dirname, "../../web/dist");try {const stat = fs.statSync(path.join(monorepoClient, "index.html"));if (stat.isFile()) return monorepoClient;@@ -109,8 +109,8 @@ async function main() {const staticDir = devUrl ? undefined : resolveStaticDir();if (!devUrl && !staticDir) {- logger.warn("renderer bundle missing and no VITE_DEV_SERVER_URL; web UI unavailable", {- hint: "Run `bun run --cwd apps/renderer build` or set VITE_DEV_SERVER_URL for dev mode.",+ logger.warn("web bundle missing and no VITE_DEV_SERVER_URL; web UI unavailable", {+ hint: "Run `bun run --cwd apps/web build` or set VITE_DEV_SERVER_URL for dev mode.",});}diff --git a/apps/server/src/wsServer.ts b/apps/server/src/wsServer.tsindex c946b1742..ae9dc7ca6 100644--- a/apps/server/src/wsServer.ts+++ b/apps/server/src/wsServer.ts@@ -109,7 +109,7 @@ export function createServer(options: ServerOptions) {return;}- // Serve static files from the renderer build+ // Serve static files from the web app buildif (!staticDir) {res.writeHead(503, { "Content-Type": "text/plain" });res.end("No static directory configured and no dev URL set.");diff --git a/apps/renderer/index.html b/apps/web/index.htmlsimilarity index 100%rename from apps/renderer/index.htmlrename to apps/web/index.htmldiff --git a/apps/renderer/package.json b/apps/web/package.jsonsimilarity index 96%rename from apps/renderer/package.jsonrename to apps/web/package.jsonindex 0c04817c8..57f79caa4 100644--- a/apps/renderer/package.json+++ b/apps/web/package.json@@ -1,5 +1,5 @@{- "name": "@t3tools/renderer",+ "name": "@t3tools/web","version": "0.0.0","private": true,"type": "module",diff --git a/apps/renderer/src/App.tsx b/apps/web/src/App.tsxsimilarity index 100%rename from apps/renderer/src/App.tsxrename to apps/web/src/App.tsxdiff --git a/apps/renderer/src/components/ChatMarkdown.tsx b/apps/web/src/components/ChatMarkdown.tsxsimilarity index 100%rename from apps/renderer/src/components/ChatMarkdown.tsxrename to apps/web/src/components/ChatMarkdown.tsxdiff --git a/apps/renderer/src/components/ChatView.tsx b/apps/web/src/components/ChatView.tsxsimilarity index 100%rename from apps/renderer/src/components/ChatView.tsxrename to apps/web/src/components/ChatView.tsxdiff --git a/apps/renderer/src/components/DiffPanel.tsx b/apps/web/src/components/DiffPanel.tsxsimilarity index 100%rename from apps/renderer/src/components/DiffPanel.tsxrename to apps/web/src/components/DiffPanel.tsxdiff --git a/apps/renderer/src/components/Sidebar.tsx b/apps/web/src/components/Sidebar.tsxsimilarity index 100%rename from apps/renderer/src/components/Sidebar.tsxrename to apps/web/src/components/Sidebar.tsxdiff --git a/apps/renderer/src/env.ts b/apps/web/src/env.tssimilarity index 95%rename from apps/renderer/src/env.tsrename to apps/web/src/env.tsindex 39c54e023..fb2e493ca 100644--- a/apps/renderer/src/env.ts+++ b/apps/web/src/env.ts@@ -1,6 +1,6 @@/*** True when running inside the Electron preload bridge, false in a regular browser.- * The preload script sets window.nativeApi via contextBridge before any renderer+ * The preload script sets window.nativeApi via contextBridge before any web-app* code executes, so this is reliable at module load time.*/export const isElectron =diff --git a/apps/renderer/src/historyBootstrap.test.ts b/apps/web/src/historyBootstrap.test.tssimilarity index 100%rename from apps/renderer/src/historyBootstrap.test.tsrename to apps/web/src/historyBootstrap.test.tsdiff --git a/apps/renderer/src/historyBootstrap.ts b/apps/web/src/historyBootstrap.tssimilarity index 100%rename from apps/renderer/src/historyBootstrap.tsrename to apps/web/src/historyBootstrap.tsdiff --git a/apps/renderer/src/hooks/useTheme.ts b/apps/web/src/hooks/useTheme.tssimilarity index 100%rename from apps/renderer/src/hooks/useTheme.tsrename to apps/web/src/hooks/useTheme.tsdiff --git a/apps/renderer/src/index.css b/apps/web/src/index.csssimilarity index 100%rename from apps/renderer/src/index.cssrename to apps/web/src/index.cssdiff --git a/apps/renderer/src/main.tsx b/apps/web/src/main.tsxsimilarity index 100%rename from apps/renderer/src/main.tsxrename to apps/web/src/main.tsxdiff --git a/apps/renderer/src/model-logic.test.ts b/apps/web/src/model-logic.test.tssimilarity index 100%rename from apps/renderer/src/model-logic.test.tsrename to apps/web/src/model-logic.test.tsdiff --git a/apps/renderer/src/model-logic.ts b/apps/web/src/model-logic.tssimilarity index 100%rename from apps/renderer/src/model-logic.tsrename to apps/web/src/model-logic.tsdiff --git a/apps/renderer/src/persistenceSchema.test.ts b/apps/web/src/persistenceSchema.test.tssimilarity index 100%rename from apps/renderer/src/persistenceSchema.test.tsrename to apps/web/src/persistenceSchema.test.tsdiff --git a/apps/renderer/src/persistenceSchema.ts b/apps/web/src/persistenceSchema.tssimilarity index 100%rename from apps/renderer/src/persistenceSchema.tsrename to apps/web/src/persistenceSchema.tsdiff --git a/apps/renderer/src/session-logic.test.ts b/apps/web/src/session-logic.test.tssimilarity index 100%rename from apps/renderer/src/session-logic.test.tsrename to apps/web/src/session-logic.test.tsdiff --git a/apps/renderer/src/session-logic.ts b/apps/web/src/session-logic.tssimilarity index 100%rename from apps/renderer/src/session-logic.tsrename to apps/web/src/session-logic.tsdiff --git a/apps/renderer/src/store.test.ts b/apps/web/src/store.test.tssimilarity index 100%rename from apps/renderer/src/store.test.tsrename to apps/web/src/store.test.tsdiff --git a/apps/renderer/src/store.ts b/apps/web/src/store.tssimilarity index 100%rename from apps/renderer/src/store.tsrename to apps/web/src/store.tsdiff --git a/apps/renderer/src/types.ts b/apps/web/src/types.tssimilarity index 100%rename from apps/renderer/src/types.tsrename to apps/web/src/types.tsdiff --git a/apps/renderer/src/vite-env.d.ts b/apps/web/src/vite-env.d.tssimilarity index 100%rename from apps/renderer/src/vite-env.d.tsrename to apps/web/src/vite-env.d.tsdiff --git a/apps/renderer/src/wsNativeApi.ts b/apps/web/src/wsNativeApi.tssimilarity index 100%rename from apps/renderer/src/wsNativeApi.tsrename to apps/web/src/wsNativeApi.tsdiff --git a/apps/renderer/src/wsTransport.ts b/apps/web/src/wsTransport.tssimilarity index 100%rename from apps/renderer/src/wsTransport.tsrename to apps/web/src/wsTransport.tsdiff --git a/apps/renderer/tsconfig.json b/apps/web/tsconfig.jsonsimilarity index 100%rename from apps/renderer/tsconfig.jsonrename to apps/web/tsconfig.jsondiff --git a/apps/renderer/vite.config.ts b/apps/web/vite.config.tssimilarity index 88%rename from apps/renderer/vite.config.tsrename to apps/web/vite.config.tsindex f5559e3d1..b46780ec5 100644--- a/apps/renderer/vite.config.ts+++ b/apps/web/vite.config.ts@@ -12,7 +12,7 @@ export default defineConfig({tailwindcss(),],define: {- // In dev mode, tell the renderer where the WebSocket server lives+ // In dev mode, tell the web app where the WebSocket server lives"import.meta.env.VITE_WS_URL": JSON.stringify(process.env.VITE_WS_URL ?? "",),diff --git a/bun.lock b/bun.lockindex 481602d8e..673257984 100644--- a/bun.lock+++ b/bun.lock@@ -28,8 +28,28 @@"wait-on": "^8.0.2",},},- "apps/renderer": {- "name": "@t3tools/renderer",+ "apps/server": {+ "name": "t3",+ "version": "0.1.0",+ "bin": {+ "t3": "./dist/index.js",+ },+ "dependencies": {+ "open": "^10.1.0",+ "ws": "^8.18.0",+ },+ "devDependencies": {+ "@t3tools/contracts": "workspace:*",+ "@t3tools/web": "workspace:*",+ "@types/node": "^22.10.2",+ "@types/ws": "^8.5.13",+ "tsup": "^8.3.5",+ "tsx": "^4.19.0",+ "typescript": "^5.7.3",+ },+ },+ "apps/web": {+ "name": "@t3tools/web","version": "0.0.0","dependencies": {"@t3tools/contracts": "workspace:*",@@ -53,26 +73,6 @@"vite": "^6.0.5",},},- "apps/server": {- "name": "t3",- "version": "0.1.0",- "bin": {- "t3": "./dist/index.js",- },- "dependencies": {- "open": "^10.1.0",- "ws": "^8.18.0",- },- "devDependencies": {- "@t3tools/contracts": "workspace:*",- "@t3tools/renderer": "workspace:*",- "@types/node": "^22.10.2",- "@types/ws": "^8.5.13",- "tsup": "^8.3.5",- "tsx": "^4.19.0",- "typescript": "^5.7.3",- },- },"packages/contracts": {"name": "@t3tools/contracts","version": "0.0.0",@@ -294,7 +294,7 @@"@t3tools/desktop": ["@t3tools/desktop@workspace:apps/desktop"],- "@t3tools/renderer": ["@t3tools/renderer@workspace:apps/renderer"],+ "@t3tools/web": ["@t3tools/web@workspace:apps/web"],"@tailwindcss/node": ["@tailwindcss/[email protected]", "", { "dependencies": { "@jridgewell/remapping": "^2.3.4", "enhanced-resolve": "^5.18.3", "jiti": "^2.6.1", "lightningcss": "1.30.2", "magic-string": "^0.30.21", "source-map-js": "^1.2.1", "tailwindcss": "4.1.18" } }, "sha512-DoR7U1P7iYhw16qJ49fgXUlry1t4CpXeErJHnQ44JgTSKMaZUdf17cfn5mHchfJ4KRBZRFA/Coo+MUF5+gOaCQ=="],diff --git a/package.json b/package.jsonindex a3429a028..27a799018 100644--- a/package.json+++ b/package.json@@ -6,14 +6,14 @@"packages/*"],"scripts": {- "dev": "T3CODE_LOG_WS_EVENTS=1 VITE_WS_URL=ws://localhost:3773 turbo run dev --ui=tui --filter=@t3tools/contracts --filter=@t3tools/renderer --filter=t3 --parallel",+ "dev": "T3CODE_LOG_WS_EVENTS=1 VITE_WS_URL=ws://localhost:3773 turbo run dev --ui=tui --filter=@t3tools/contracts --filter=@t3tools/web --filter=t3 --parallel","dev:server": "bun run build:contracts && bun run --cwd apps/server dev",- "dev:web": "VITE_WS_URL=ws://localhost:3773 bun run --cwd apps/renderer dev",+ "dev:web": "VITE_WS_URL=ws://localhost:3773 bun run --cwd apps/web dev","dev:desktop": "bun run --cwd apps/desktop dev","start": "node apps/server/dist/index.js","start:desktop": "bun run --cwd apps/desktop start","build": "turbo run build",- "build:desktop": "bun run build:contracts && bun run --cwd apps/renderer build && bun run --cwd apps/server build && bun run --cwd apps/desktop build",+ "build:desktop": "bun run build:contracts && bun run --cwd apps/web build && bun run --cwd apps/server build && bun run --cwd apps/desktop build","typecheck": "turbo run typecheck","lint": "oxlint --report-unused-disable-directives","test": "turbo run test",