# pingdotgg/t3code architecture

> Architecture diagram of the GitHub repository pingdotgg/t3code, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pingdotgg/t3code
- Repository: https://github.com/pingdotgg/t3code
- Video tour (about a minute): https://gitdiagram.com/pingdotgg/t3code/video

## Overview

T3 Code is a multi-client control surface for coding agents running on user machines: desktop, web, and iOS/Android clients connect users to server-managed environments and agent workflows. The README establishes that product flow and supported clients/providers; sampled files show mobile connection and voice-input controllers, web preview synchronization, and review-guide logic. The tree also identifies desktop preview, capture, backend, and IPC subsystems. Several server orchestration and provider implementations are not present in the sampled excerpts, so their internal call paths are omitted rather than inferred.

Main entry points: [`apps/server/src/config.ts`](https://github.com/pingdotgg/t3code/blob/main/apps/server/src/config.ts) (Agent server), [`apps/mobile/src/App.tsx`](https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/App.tsx) (Mobile app), [`apps/web/src/components/chat/useDraftEnvironmentRouting.ts`](https://github.com/pingdotgg/t3code/blob/main/apps/web/src/components/chat/useDraftEnvironmentRouting.ts) (Web app), [`apps/desktop/src/app/DesktopApp.ts`](https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/app/DesktopApp.ts) (Desktop shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_mobile["Mobile app<br/>[App.tsx]"]
  node_web["Web app"]
  node_mobile_connect["Connection control"]
  node_mobile_voice["Voice input"]
  node_mobile_browser["Browser preview"]
  node_mobile_review["Review comments"]
  node_web_cloud["Cloud linking"]
  node_web_preview["Preview sessions"]
end

subgraph group_server["Server workflows"]
  node_server["Agent server<br/>[config.ts]"]
  node_orchestrator["Agent orchestration"]
  node_provider["Agent providers<br/>[client.ts]"]
  node_terminal["Terminal sessions<br/>[Manager.ts]"]
  node_git["Git operations<br/>[GitManager.ts]"]
  node_review_guide["PR review guides"]
  node_database[("Persistent state<br/>[DatabaseStorage.ts]")]
end

subgraph group_desktop["Desktop runtime"]
  node_desktop_app["Desktop shell<br/>[DesktopApp.ts]"]
  node_desktop_ipc["Desktop IPC<br/>[DesktopIpc.ts]"]
  node_desktop_backend["Local backend"]
  node_desktop_preview["Desktop preview<br/>[Manager.ts]"]
  node_desktop_capture["Screen capture<br/>[DesktopSnapShot.ts]"]
end

subgraph group_shared["Shared runtime"]
  node_runtime_voice["Voice runtime<br/>[controller.ts]"]
  node_connection_doc["Connection catalog<br/>[storageDocument.ts]"]
  node_contracts["Shared contracts<br/>[server.ts]"]
end

node_user(("Developer"))

node_user -->|"uses"| node_mobile
node_user -->|"uses"| node_web
node_user -->|"uses"| node_desktop_app
node_mobile -->|"manages connections"| node_mobile_connect
node_mobile -->|"starts voice input"| node_mobile_voice
node_mobile -->|"views previews"| node_mobile_browser
node_mobile -->|"selects review comments"| node_mobile_review
node_mobile_voice -->|"uses"| node_runtime_voice
node_web -->|"configures access"| node_web_cloud
node_web -->|"synchronizes previews"| node_web_preview
node_mobile_connect -->|"registers environments"| node_connection_doc
node_mobile -->|"controls agents"| node_server
node_web -->|"controls agents"| node_server
node_desktop_app -.->|"communicates through"| node_desktop_ipc
node_desktop_backend -.->|"hosts environment"| node_server
node_server -.->|"runs agent workflows"| node_orchestrator
node_orchestrator -.->|"dispatches to"| node_provider
node_orchestrator -.->|"manages sessions"| node_terminal
node_server -.->|"supports source control"| node_git
node_server -->|"generates review guidance"| node_review_guide
node_server -.->|"persists state"| node_database
node_desktop_app -.->|"offers browser preview"| node_desktop_preview
node_desktop_app -.->|"offers screen capture"| node_desktop_capture
node_server -.->|"exposes shared types"| node_contracts

click node_mobile "https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/App.tsx"
click node_web "https://github.com/pingdotgg/t3code/blob/main/apps/web/src/components/chat/useDraftEnvironmentRouting.ts"
click node_mobile_connect "https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/features/connection/useConnectionController.ts"
click node_mobile_voice "https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/features/voice-input/useVoiceInputController.ts"
click node_mobile_browser "https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/features/browser/BrowserPreviewRouteScreen.tsx"
click node_mobile_review "https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/features/review/useReviewCommentSelectionController.ts"
click node_web_cloud "https://github.com/pingdotgg/t3code/blob/main/apps/web/src/cloud/useCloudLinkController.ts"
click node_web_preview "https://github.com/pingdotgg/t3code/blob/main/apps/web/src/components/preview/usePreviewSession.ts"
click node_server "https://github.com/pingdotgg/t3code/blob/main/apps/server/src/config.ts"
click node_orchestrator "https://github.com/pingdotgg/t3code/tree/main/apps/server/src/orchestration-v2"
click node_provider "https://github.com/pingdotgg/t3code/blob/main/packages/provider-core/src/client.ts"
click node_terminal "https://github.com/pingdotgg/t3code/blob/main/apps/server/src/terminal/Manager.ts"
click node_git "https://github.com/pingdotgg/t3code/blob/main/apps/server/src/git/GitManager.ts"
click node_review_guide "https://github.com/pingdotgg/t3code/blob/main/apps/server/src/pullRequest/PullRequestReviewGuideService.ts"
click node_database "https://github.com/pingdotgg/t3code/blob/main/apps/server/src/persistence/DatabaseStorage.ts"
click node_desktop_app "https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/app/DesktopApp.ts"
click node_desktop_ipc "https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/ipc/DesktopIpc.ts"
click node_desktop_backend "https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/backend/DesktopBackendManager.ts"
click node_desktop_preview "https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/preview/Manager.ts"
click node_desktop_capture "https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/snapShot/DesktopSnapShot.ts"
click node_runtime_voice "https://github.com/pingdotgg/t3code/blob/main/packages/client-runtime/src/voice-input/controller.ts"
click node_connection_doc "https://github.com/pingdotgg/t3code/blob/main/packages/client-runtime/src/platform/storageDocument.ts"
click node_contracts "https://github.com/pingdotgg/t3code/blob/main/packages/contracts/src/server.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mobile,node_web,node_mobile_connect,node_mobile_voice,node_mobile_browser,node_mobile_review,node_web_cloud,node_web_preview toneBlue
class node_server,node_orchestrator,node_provider,node_terminal,node_git,node_review_guide,node_database toneAmber
class node_desktop_app,node_desktop_ipc,node_desktop_backend,node_desktop_preview,node_desktop_capture toneMint
class node_runtime_voice,node_connection_doc,node_contracts toneRose
class node_user toneIndigo
```

## Components

### User clients

- [Mobile app](https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/App.tsx): `apps/mobile/src/App.tsx`
- [Web app](https://github.com/pingdotgg/t3code/blob/main/apps/web/src/components/chat/useDraftEnvironmentRouting.ts): `apps/web/src/components/chat/useDraftEnvironmentRouting.ts`
- [Connection control](https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/features/connection/useConnectionController.ts): `apps/mobile/src/features/connection/useConnectionController.ts`
- [Voice input](https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/features/voice-input/useVoiceInputController.ts): `apps/mobile/src/features/voice-input/useVoiceInputController.ts`
- [Browser preview](https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/features/browser/BrowserPreviewRouteScreen.tsx): `apps/mobile/src/features/browser/BrowserPreviewRouteScreen.tsx`
- [Review comments](https://github.com/pingdotgg/t3code/blob/main/apps/mobile/src/features/review/useReviewCommentSelectionController.ts): `apps/mobile/src/features/review/useReviewCommentSelectionController.ts`
- [Cloud linking](https://github.com/pingdotgg/t3code/blob/main/apps/web/src/cloud/useCloudLinkController.ts): `apps/web/src/cloud/useCloudLinkController.ts`
- [Preview sessions](https://github.com/pingdotgg/t3code/blob/main/apps/web/src/components/preview/usePreviewSession.ts): `apps/web/src/components/preview/usePreviewSession.ts`

### Server workflows

- [Agent server](https://github.com/pingdotgg/t3code/blob/main/apps/server/src/config.ts): `apps/server/src/config.ts`
- [Agent orchestration](https://github.com/pingdotgg/t3code/tree/main/apps/server/src/orchestration-v2): `apps/server/src/orchestration-v2`
- [Agent providers](https://github.com/pingdotgg/t3code/blob/main/packages/provider-core/src/client.ts): `packages/provider-core/src/client.ts`
- [Terminal sessions](https://github.com/pingdotgg/t3code/blob/main/apps/server/src/terminal/Manager.ts): `apps/server/src/terminal/Manager.ts`
- [Git operations](https://github.com/pingdotgg/t3code/blob/main/apps/server/src/git/GitManager.ts): `apps/server/src/git/GitManager.ts`
- [PR review guides](https://github.com/pingdotgg/t3code/blob/main/apps/server/src/pullRequest/PullRequestReviewGuideService.ts): `apps/server/src/pullRequest/PullRequestReviewGuideService.ts`
- [Persistent state](https://github.com/pingdotgg/t3code/blob/main/apps/server/src/persistence/DatabaseStorage.ts): `apps/server/src/persistence/DatabaseStorage.ts`

### Desktop runtime

- [Desktop shell](https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/app/DesktopApp.ts): `apps/desktop/src/app/DesktopApp.ts`
- [Desktop IPC](https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/ipc/DesktopIpc.ts): `apps/desktop/src/ipc/DesktopIpc.ts`
- [Local backend](https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/backend/DesktopBackendManager.ts): `apps/desktop/src/backend/DesktopBackendManager.ts`
- [Desktop preview](https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/preview/Manager.ts): `apps/desktop/src/preview/Manager.ts`
- [Screen capture](https://github.com/pingdotgg/t3code/blob/main/apps/desktop/src/snapShot/DesktopSnapShot.ts): `apps/desktop/src/snapShot/DesktopSnapShot.ts`

### Shared runtime

- [Voice runtime](https://github.com/pingdotgg/t3code/blob/main/packages/client-runtime/src/voice-input/controller.ts): `packages/client-runtime/src/voice-input/controller.ts`
- [Connection catalog](https://github.com/pingdotgg/t3code/blob/main/packages/client-runtime/src/platform/storageDocument.ts): `packages/client-runtime/src/platform/storageDocument.ts`
- [Shared contracts](https://github.com/pingdotgg/t3code/blob/main/packages/contracts/src/server.ts): `packages/contracts/src/server.ts`

### Other components

- **Developer**

## Connections

- Developer → Mobile app: uses (evidence: `README.md`)
- Developer → Web app: uses (evidence: `README.md`)
- Developer → Desktop shell: uses (evidence: `README.md`)
- Mobile app → Connection control: manages connections (evidence: `apps/mobile/src/features/connection/useConnectionController.ts`)
- Mobile app → Voice input: starts voice input (evidence: `apps/mobile/src/features/voice-input/useVoiceInputController.ts`)
- Mobile app → Browser preview: views previews (evidence: `apps/mobile/src/features/browser/BrowserPreviewRouteScreen.tsx`)
- Mobile app → Review comments: selects review comments (evidence: `apps/mobile/src/features/review/useReviewCommentSelectionController.ts`)
- Voice input → Voice runtime: uses (evidence: `apps/mobile/src/features/voice-input/useVoiceInputController.ts`)
- Web app → Cloud linking: configures access (evidence: `apps/web/src/cloud/useCloudLinkController.ts`)
- Web app → Preview sessions: synchronizes previews (evidence: `apps/web/src/components/preview/usePreviewSession.ts`)
- Connection control → Connection catalog: registers environments (evidence: `apps/mobile/src/features/connection/useConnectionController.ts`)
- Mobile app → Agent server: controls agents (evidence: `README.md`)
- Web app → Agent server: controls agents (evidence: `README.md`)
- Desktop shell → Desktop IPC: communicates through
- Local backend → Agent server: hosts environment
- Agent server → Agent orchestration: runs agent workflows
- Agent orchestration → Agent providers: dispatches to
- Agent orchestration → Terminal sessions: manages sessions
- Agent server → Git operations: supports source control
- Agent server → PR review guides: generates review guidance (evidence: `apps/server/src/pullRequest/PullRequestReviewGuideService.ts`)
- Agent server → Persistent state: persists state (evidence: `apps/server/src/persistence/DatabaseStorage.ts`)
- Desktop shell → Desktop preview: offers browser preview
- Desktop shell → Screen capture: offers screen capture
- Agent server → Shared contracts: exposes shared types
