You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Oct 10, 2026. It is now read-only.
Repository navigation
Commit 9dd425b
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: AGENTS.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,7 +28,7 @@ T3 Code has 3 key app surfaces: **web**, **desktop**, and **mobile**.
28
28
29
29
**Desktop** is the main surface most users install first. It's a full Electron app that bundles the server runner as well. The desktop app can also be used as the host server, allowing remote connections from app.t3.codes or the mobile app.
30
30
31
-
**Mobile** is a React native app for both iOS and Android. The mobile app allows for connecting to any T3 Code server to control work remotely. It is still in early access (Testflight), but it is pretty close to shipping globally.
31
+
**Mobile** is a React Native app for both iOS and Android, available on the App Store and Google Play. The mobile app allows for connecting to any T3 Code server to control work remotely.
32
32
33
33
## A note from Theo
34
34
@@ -72,7 +72,7 @@ The most common defect in this repo is a change that works on the path you teste
72
72
-**Contracts.** Anything crossing the wire is typed in `packages/contracts`. Change the schema and the server, web, mobile, and desktop all follow.
73
73
-**Reverse states.** If you added a way in, add the way out and the way to see it. Snooze needs unsnooze. Close needs reopen. A one-way door is a bug.
74
74
-**Connection modes.** Local, remote/relay, and tunnel behave differently. Multi-device and multi-environment cases are real.
75
-
-**Docs.**`docs/`mirrors this structure. Behavior changes that a user would notice belong in `docs/user/`; architecture changes in `docs/architecture/`; new vocabulary in `docs/reference/encyclopedia.md`.
75
+
-**Docs.**`docs/`splits by audience. Behavior changes that a user would notice belong in `docs/user/` (shipped-product voice, no repo tooling or source paths); architecture and contributor changes in `docs/internals/`; runbooks in `docs/operations/`; new vocabulary in `docs/internals/glossary.md`.
76
76
77
77
## Dev servers
78
78
@@ -123,13 +123,13 @@ An empty database is a bad test. Seed your worktree's `.t3` with a copy of real
123
123
124
124
Clients send typed WebSocket requests. The server turns them into _commands_, a pure _decider_ turns commands into persisted _events_, and a _projector_ derives the read model the UI renders. Provider CLIs run as subprocesses; per-provider _adapters_ translate their native protocols into orchestration events. Side effects run in queue-backed _reactors_ that emit _receipts_ when milestones land. Each turn ends with a _checkpoint_, a hidden git ref, so the app can diff and restore.
125
125
126
-
Full glossary with file links: `docs/reference/encyclopedia.md`
126
+
Full glossary with file links: `docs/internals/glossary.md`
-`apps/web` - React/Vite UI. `apps/desktop` wraps it, `apps/mobile` is React Native, `apps/marketing` is the site.
132
-
-`packages/contracts` - Effect/Schema contracts. Schema only, no runtime logic.
132
+
-`packages/contracts` - Effect/Schema contracts plus small derived helpers. No heavy runtime logic.
133
133
-`packages/shared` - shared runtime utils, subpath exports, no barrel.
134
134
-`packages/client-runtime` - client code shared by web and mobile.
135
135
-`.repos/` - vendored read-only references. Prefer their patterns over invented ones. Never edit or import from them. Sync with `vpr sync:repos` when bumping the matching dependency.
Copy file name to clipboardExpand all lines: README.md
+14-11Lines changed: 14 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,13 +17,13 @@ We wanted something performant, remote-ready, and truly open. If we ever go the
17
17
>
18
18
> - Codex: install [Codex CLI](https://developers.openai.com/codex/cli) and run `codex login`
19
19
> - Claude: install [Claude Code](https://claude.com/product/claude-code) and run `claude auth login`
20
-
> - Cursor: install [Cursor CLI](https://cursor.com/cli) and run `cursor-agent login`
20
+
> - Cursor: install [Cursor CLI](https://cursor.com/cli) and run `agent login`
21
21
> - Grok Build: install [Grok Build CLI](https://x.ai/cli) and run `grok login`
22
22
> - OpenCode: install [OpenCode](https://opencode.ai) and run `opencode auth login`
23
23
24
24
### Try it out (install-free)
25
25
26
-
The easiest way to test T3 Code is to run the server in your terminal:
26
+
The easiest way to test T3 Code is to run the server in your terminal (requires Node.js 22.16+, 23.11+, or 24.10+):
27
27
28
28
```bash
29
29
npx t3@latest
@@ -61,17 +61,20 @@ We are very very early in this project. Expect bugs.
61
61
62
62
We are (mostly) not accepting contributions yet. Small fixes may be considered. Big features will not be.
63
63
64
-
There's no public docs site yet, checkout the miscellaneous markdown files in [docs](./docs).
0 commit comments