개요
pingdotgg/t3code는 스스로를 **“agent harness control surface”**라고 부르는 오픈소스(MIT, TypeScript) 앱이다. 에이전트 CLI를 직접 구현하지 않고, 내 컴퓨터에 이미 로그인된 구독을 그대로 빌려 하나의 UI에서 제어한다. 2026-02 공개, 2026-10-04 기준 스타 약 2.5만, 최신 릴리스 v0.0.45(2026-10-02). 홈페이지는 t3.codes. 저자들은 Codex 데스크톱 앱, Conductor, Claude Desktop, Cursor Glass에서 영감을 받았지만 기준에 못 미쳐 직접 만들었고, “방향이 틀어지면 포크해서 원하는 에디터를 만들 수 있게” 완전 공개를 내세운다.
지원 에이전트
Claude Code·codex·cursor·Grok Build·opencode·Google Antigravity를 지원한다.
각 CLI를 설치하고 로그인(codex login, claude auth login, agent login 등)해 두면 T3 Code가 이를 제어한다. Antigravity만은 CLI 없이 설정에서 Google 로그인으로 쓴다.
제공 형태
| 형태 | 설치 |
|---|---|
| CLI/웹 | 공식 install 스크립트 후 t3 실행, 설치 없이 npx t3@latest |
| 데스크톱(Electron) | Homebrew cask t3-code, winget T3Tools.T3Code, .deb, AUR |
| 모바일 | iOS·Android 앱 |
| 웹 | app.t3.codes |
t3 service install로 백그라운드 서비스를 띄우고, t3 update로 갱신한다.
원격 접근
에이전트는 **워크스페이스가 있는 머신(서버)**에서 실행되고, 웹·데스크톱·모바일 클라이언트는 인증된 RPC로 이를 조작한다.
- T3 Connect: 공유기 포트포워딩 없이 다른 기기에서 환경에 접속한다(
t3 connect, 데스크톱 Settings → Connections). - LAN·사설망 직접 페어링 링크도 지원한다.
- 호스트 머신은 작업 내내 켜져 있고 닿을 수 있어야 한다.
아키텍처 메모
공개된 docs/internals와 저장소 구조에서 읽히는 설계다.
- 모노레포:
apps/(desktop·server·web·mobile·marketing),packages/(contracts, client-runtime, shared, ssh, tailscale, effect-acp, effect-codex-app-server). - 실행 소유권은 서버: 프로바이더 프로세스·터미널·Git·프로젝트 파일은 서버가 갖고, 원격 클라이언트는 자기 파일시스템이나 자격증명으로 대체하지 않는다.
- 이벤트 로그가 진실의 원천: 오케스트레이터가 명령을 직렬화해 이벤트를 결정하고, 이벤트·프로젝션·명령 영수증·아웃박스를 한 DB 트랜잭션으로 커밋한다. 외부 I/O는 이후 effect worker가 수행해 명령 재시도가 멱등하다.
- 프로바이더 어댑터: 프로바이더별 동작은 어댑터 뒤에 숨겨 오케스트레이션은 정규화된 명령·이벤트만 다룬다.
- 클라이언트·서버가 독립적으로 버전업되므로 기능은 클라이언트 버전이 아니라 환경 descriptor의 capability 플래그로 협상한다.
4월 스냅샷과의 변화
2026-04-19 시점(v0.0.20, 스타 9.7k)에는 Codex·Claude만 지원하는 “최소한의 웹 GUI”였다. 반년 만에 지원 에이전트가 6종으로, 접근 형태가 웹·데스크톱에서 모바일·원격(T3 Connect)까지 넓어졌고 스타는 약 2.5배가 됐다. T3 Stack(Next.js·tRPC·Tailwind)을 만든 pingdotgg(T3 Tools) 팀 작품이며, 서버는 Effect RPC·레이어 기반 시작 구조 위에 체크포인트·diff 조회, 터미널 매니저, 서버 인증·페어링을 갖춘다. 4월 기준 발표된 IDE 연동은 VS Code·Kiro·Trae.
유의점
- 매우 초기 단계(“Expect bugs”)이며 기여는 작은 수정만 받는다. 문서 사이트는 아직 없다.
- 아키텍처 내용은 README와 docs 일부에서 확인한 것이며 코드 전체를 검증하지는 않았다.
관련
- 2026-10-20-x-aicodeking-pandacode — T3 Code에서 영감을 받은 12MB Rust 에이전트 GUI
- moc-ai-agents-harness — 에이전트 하네스 모음
- moc-ai-coding — AI 코딩 도구 모음