How pingdotgg/t3code works
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: config.ts Agent server · App.tsx Mobile app · useDraftEnvironmentRouting.ts Web app · DesktopApp.ts Desktop shell
Components 24
User clients
- Mobile app
apps/mobile/src/App.tsx - Web app
apps/web/src/components/chat/useDraftEnvironmentRouting.ts - Connection control
apps/mobile/src/features/connection/useConnectionController.ts - Voice input
apps/mobile/src/features/voice-input/useVoiceInputController.ts - Browser preview
apps/mobile/src/features/browser/BrowserPreviewRouteScreen.tsx - Review comments
apps/mobile/src/features/review/useReviewCommentSelectionController.ts - Cloud linking
apps/web/src/cloud/useCloudLinkController.ts - Preview sessions
apps/web/src/components/preview/usePreviewSession.ts
Server workflows
- Agent server
apps/server/src/config.ts - Agent orchestration
apps/server/src/orchestration-v2 - Agent providers
packages/provider-core/src/client.ts - Terminal sessions
apps/server/src/terminal/Manager.ts - Git operations
apps/server/src/git/GitManager.ts - PR review guides
apps/server/src/pullRequest/PullRequestReviewGuideService.ts - Persistent state
apps/server/src/persistence/DatabaseStorage.ts
Desktop runtime
- Desktop shell
apps/desktop/src/app/DesktopApp.ts - Desktop IPC
apps/desktop/src/ipc/DesktopIpc.ts - Local backend
apps/desktop/src/backend/DesktopBackendManager.ts - Desktop preview
apps/desktop/src/preview/Manager.ts - Screen capture
apps/desktop/src/snapShot/DesktopSnapShot.ts
Shared runtime
- Voice runtime
packages/client-runtime/src/voice-input/controller.ts - Connection catalog
packages/client-runtime/src/platform/storageDocument.ts - Shared contracts
packages/contracts/src/server.ts
Other components
- Developer
Connections 24
- Developer → Mobile app: uses
README.md - Developer → Web app: uses
README.md - Developer → Desktop shell: uses
README.md - Mobile app → Connection control: manages connections
apps/mobile/src/features/connection/useConnectionController.ts - Mobile app → Voice input: starts voice input
apps/mobile/src/features/voice-input/useVoiceInputController.ts - Mobile app → Browser preview: views previews
apps/mobile/src/features/browser/BrowserPreviewRouteScreen.tsx - Mobile app → Review comments: selects review comments
apps/mobile/src/features/review/useReviewCommentSelectionController.ts - Voice input → Voice runtime: uses
apps/mobile/src/features/voice-input/useVoiceInputController.ts - Web app → Cloud linking: configures access
apps/web/src/cloud/useCloudLinkController.ts - Web app → Preview sessions: synchronizes previews
apps/web/src/components/preview/usePreviewSession.ts - Connection control → Connection catalog: registers environments
apps/mobile/src/features/connection/useConnectionController.ts - Mobile app → Agent server: controls agents
README.md - Web app → Agent server: controls agents
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
apps/server/src/pullRequest/PullRequestReviewGuideService.ts - Agent server → Persistent state: persists state
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