AI 요약
Tether는 Pi 생태계(@earendil-works/pi-*)를 기반으로 구축된 로컬 AI 코딩 데스크톱 워크벤치로, Electron 37 + React 19 + TypeScript 5.9 스택으로 개발되었다. 모델 호출, 파일 도구, 터미널 명령, 권한 승인, 세션 기록, Diff 검토를 하나의 앱에 통합하고, 설정·자격증명·세션은 로컬 ~/.tether에 저장하며 모델 요청은 중계 서비스 없이 사용자가 설정한 서비스 제공자나 로컬 게이트웨이에 직접 연결한다. Agent 루프·모델 프로토콜·도구 호출·RPC는 Pi 생태계를 재사용하고, tether-agent-core가 권한 모델·샌드박스·파일 체크포인트·MCP·Hooks를 보완한다. 렌더러 프로세스는 contextIsolation과 sandbox를 활성화하고 nodeIntegration을 비활성화하여 제로 권한 원칙을 따르며, Agent는 별도 자식 프로세스로 실행되어 UI 생명주기와 분리된다. 파일 접근은 워크스페이스 화이트리스트, 어휘 검증, realpath 재검증의 3단계 검증을 거친다.
핵심 포인트
- Electron 37 + React 19 + TypeScript 5.9(strict) + Vite 7/tsup 8 + Vitest 3 스택, tether-agent-core 0.1.21 사용
- MIT 라이선스, 공식 사이트 tether-code.xyz, GitHub 저장소 github.com/tt-11-dd/te… 공개
- 렌더러 제로 권한 + Agent 자식 프로세스 분리(ELECTRON_RUN_AS_NODE=1)로 크래시 격리
- 파일 접근 3단계 검증: 워크스페이스 화이트리스트 → path.resolve 어휘 검증 → realpath 심볼릭 링크 재검증
향후 전망
- 로컬 우선(local-first) AI 코딩 도구의 프라이버시 강점이 부각되며 Pi 생태계 확장 가능성
- IPC 계약 기반 타입 안전 설계가 데스크톱 AI 에이전트의 표준 아키텍처로 자리잡을 전망
출처:juejin