개요

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 일부에서 확인한 것이며 코드 전체를 검증하지는 않았다.

관련