# pingdotgg/t3code
*public · TypeScript · ★ 14740 · 7 trails · 1 tour*

## Trails
1. **Generating Sidebar Thread Titles** — 7 markers · SquallLeonhart13
   **Default.** A new thread starts titled `New thread`, and the sidebar renders that title verbatim.
   
   **Trigger.** On the first user turn, an LLM writes a short title from the message and a `thread.meta
   https://app.principal-ade.com/trail/a5c1e472-293e-4bab-8283-af567ae5c7b1
2. **The WSL backend lets Windows users run their projects on Linux without leaving the app** — 8 markers · SquallLeonhart13
   **Default.** The desktop app runs one backend — the Windows-native Node server that the pool registers as its primary — and the WSL backend is off.
   
   **On enable.** Picking a distro in the Connections
   https://app.principal-ade.com/trail/9692303b-0e4a-410a-94da-d57b62a1867f
3. **t3code: VCS status broadcasts on demand, no worktree watcher** — 7 markers · SquallLeonhart13
   **Default.** A WebSocket client subscribes via `subscribeVcsStatus` and gets an initial snapshot plus live updates from a per-cwd `changesPubSub`, fingerprint-deduped against the prior status.
   
   **Trig
   https://app.principal-ade.com/trail/c5324dc5-7f46-4e30-8dc5-430e852cbd7a
4. **Mobile renders code with Shiki, tokenizing via a native engine with a JavaScript fallback** — 8 markers · SquallLeonhart13
   **Engine.** The mobile app highlights code with `shiki`; `getHighlighter` builds a `createHighlighterCore` instance backed by `react-native-shiki-engine`'s native regex engine, falling back to `create
   https://app.principal-ade.com/trail/ce0463fe-e26d-4a03-ade6-7eb4cc261d20
5. **t3code: VCS status broadcasts on demand, no worktree watcher** — 7 markers · SquallLeonhart13
   **Default.** A WebSocket client subscribes via `subscribeVcsStatus` and gets an initial snapshot plus live updates from a per-cwd `changesPubSub`, fingerprint-deduped against the prior status.
   
   **Trig
   https://app.principal-ade.com/trail/8350fec6-d7dc-4745-8d87-085e5638fffe
6. **Git status updates via polling with 1-second cache and fingerprint-based change detection** — 8 markers · FlanneryAllen
   **Steady state.** The `VcsStatusBroadcaster` runs background polling every 30 seconds while the `GitManager` caches status with a 1-second TTL.
   
   **On subscribe.** Client Effect atoms in `gitStatusStat
   https://app.principal-ade.com/trail/26306e9a-f9fa-4e32-a81b-24bff31d1d6b
7. **How does t3code watch files and surface git changes to the user?** — 11 markers · FlanneryAllen
   **No file watching.** This project doesn't use filesystem watchers (like `chokidar` or `fs.watch`). Instead, git status updates flow through a polling and event-driven architecture.
   
   **Periodic pollin
   https://app.principal-ade.com/trail/68515b82-afc2-4158-887b-d45ec96a1f7e

## Tours
1. **T3 Code Architecture Tour** — 8 steps
   https://app.principal-ade.com/pingdotgg/t3code

---
Repository: https://github.com/pingdotgg/t3code
Interactive view: https://app.principal-ade.com/pingdotgg/t3code
JSON: https://app.principal-ade.com/api/repos/pingdotgg/t3code
To open a trail or tour locally in the interactive viewer, see https://app.principal-ade.com for the Principal CLI quickstart.
