facts: Orch term의 구성 요소와 기술 스택
이번에 공개된 Orch term은 Claude Code, Codex, Gemini CLI 등 서로 다른 AI 코딩 에이전트를 단일 창에서 동시에 구동하고 조율하는 데스크톱 애플리케이션이다. Windows와 macOS 환경을 지원하며, 터미널과 코드 에디터, 브라우저, Git 도구를 하나의 워크스페이스에 통합한 구조를 가진다.
기술 스택은 Rust 기반의 Tauri 2를 백엔드로 사용하며, 프론트엔드는 TypeScript와 Vite로 구성했다. 터미널 구현에는 WebGL 렌더러를 사용하는 xterm.js를 채택해 렌더링 성능을 확보했고, 내부 데이터 저장소로는 SQLite를 사용한다. 자동 업데이트 기능이 내장되어 있으며, 설치 파일은 Windows용 MSI와 macOS용 DMG 형태로 제공된다.
워크스페이스 내부에는 다음과 같은 기능적 요소가 포함된다.
- 이진 분할 트리(Binary Partition Tree) 방식의 자유로운 화면 분할
- 여러 인코딩과 줄바꿈을 지원하는 내장 코드 에디터 및 ripgrep 기반 전체 검색(Ctrl+Shift+F)
- 커밋 로그, 그래프, blame, diff, push/pull 기능을 포함한 Source Control 패널
- iframe이 아닌 네이티브 자식 웹뷰 기반의 인앱 브라우저
- 작업 단위로 할 일을 관리하는 Space별 칸반 보드
how-it-works: 멀티 에이전트 오케스트레이션과 인터페이스 구조
개발자가 체감하는 핵심 작동 방식은 AI 에이전트의 격리와 협업 구조에 있다. Orch term은 여러 워커 에이전트를 각각 격리된 git worktree에 배치한다. 이는 에이전트들이 서로 다른 브랜치나 작업 상태에서 병렬로 작업을 수행하게 함으로써, 한 에이전트의 작업이 다른 에이전트의 환경을 오염시키지 않도록 설계된 구조다. 특정 워커 에이전트가 작업 중 병목 현상을 겪거나 막히는 경우, 다른 워커에게 작업을 위임하고 그 결과를 다시 되돌려 받는 오케스트레이션이 가능하다.
사람과 AI의 협업 지점은 MCP(Model Context Protocol)를 통해 구현된다. 각 Space에 배치된 칸반식 할 일 보드는 단순한 메모장이 아니라, AI 에이전트가 MCP를 통해 직접 읽고 쓸 수 있는 공통 작업판으로 작동한다. 에이전트는 자신의 작업 진행 상태를 할 일 보드에 직접 갱신하며, 사용자는 이를 실시간으로 확인하며 조율한다.
인앱 브라우저의 경우, 일반적인 iframe 방식이 아니라 Tauri의 네이티브 자식 웹뷰를 사용해 구현했다. 이를 통해 에이전트가 브라우저에서 수행하는 작업을 사용자가 함께 보는 미러링 기능을 제공한다. 개발 과정에서 Tauri의 unstable한 네이티브 자식 웹뷰로 인해 동기 커맨드가 메인 스레드를 데드락(Deadlock)시키거나, 창 복귀 시 키보드 입력이 끊기는 포커스 버그가 발생했으며, 이는 wry 라이브러리를 직접 패치하는 방식으로 해결했다.
implementation-impact: 개발 워크플로우의 변화와 API 확장성
실무자가 도입 시 주목해야 할 지점은 AI 에이전트를 로컬 서비스화하는 'AI 게이트웨이' 기능이다. Orch term은 앱 내부에서 구동되는 AI 에이전트를 OpenAI 호환 형태의 로컬 HTTP API로 노출한다. 이를 통해 개발자는 Orch term 외부의 스크립트나 별도 도구에서 API 호출만으로 내부 에이전트를 제어할 수 있다. 모든 요청과 응답은 날짜별 감사 로그로 기록되어, 에이전트의 작업 이력을 추적하고 검증하는 용도로 활용 가능하다.
운영 환경에서는 OS별 입력 처리 방식의 차이를 고려해야 한다. Windows 환경의 conpty(Console Pseudo-terminal) 환경에서 발생하는 한글 IME 및 이모지 입력 오류, Alt+Tab 전환 후의 중복 입력 버그 등이 기술적 제약으로 작용했다. Orch term은 이를 해결하기 위해 모든 OS 분기를 게이트(Gate) 처리하여 양립성을 확보했다.
결과적으로 개발자는 터미널과 에디터, 브라우저를 오가는 컨텍스트 스위칭 비용을 줄이고, 단일 인터페이스 내에서 여러 AI 에이전트의 작업 상태를 칸반 보드와 git worktree 단위로 관리하는 운영 방식으로 전환하게 된다. 제품의 상세 내용과 다운로드는 공식 페이지(https://zendy00.github.io/orch-term-pages/)에서 확인할 수 있다.
