longhouse

Longhouse는 코딩 에이전트를 위한 원격 제어 및 검색 가능한 타임라인 역할을 하는 오픈 소스 도구입니다. 에이전트 런타임을 대체하는 것이 아니라, 여러 공급자와 기기에서 실행 중인 세션을 통합합니다. 웹 인터페이스를 통해 실시간 세션을 시청하고, 에이전트의 모든 작업 기록을 검색하며, 에이전트가 로컬 터미널에서 실행되는 동안 다음 지시를 보낼 수 있습니다. 지원되는 공급자로는 Claude Code, Codex CLI, Cursor Agent, OpenCode, Antigravity, Pi Agent가 있습니다. 각 공급자는 하나의 검색 가능한 타임라인으로 동기화됩니다. 원격 제어 수준은 공급자마다 다르며, Claude Code와 Codex는 검색, 실행, 중단, 중간 단계 제어 및 재개가 가능합니다. Cursor와 OpenCode는 검색, 실행, 중단, 재개를 지원하지만 중간 단계 제어는 불가능합니다. Antigravity는 검색과 실행을 지원하지만 중단, 종료, 재연결은 지원하지 않으며 후크가 설치되지 않으면 시작되지 않습니다. 일반 CLI 세션도 타임라인에 포함되지만 관리되지 않는 상태로 유지되어 검색과 관찰만 가능합니다. 아키텍처는 두 가지 주요 구성 요소로 나뉩니다. Machine Agent는 각 개발 머신에서 실행되어 세션 이벤트를 전송하는 Rust 엔진입니다. Runtime Host는 웹 UI와 SQLite 저장소가 포함된 FastAPI 애플리케이션으로, 지속성이 필요한 곳에 배치됩니다. 노트북에서는 두 구성 요소를 함께 실행할 수 있으며, 안정적인 운영을 위해 VPS, 홈랩, Mac mini 등 항상 켜져 있는 서버에 Runtime Host를 설치할 수 있습니다. 웹 UI는 기본적으로 http://localhost:8080에서 제공됩니다. 설치 옵션으로는 macOS 앱, Linux/WSL/Mac용 셸 설치 프로그램, Runtime Host 운영자를 위한 서버 설치 프로그램이 있습니다. 셸 설치 프로그램은 네이티브 페어를 설정하며, 설치 후 longhouse auth로 인증하고 longhouse machine repair로 기기를 복구할 수 있습니다. Runtime Host를 자체 호스팅하려면 비밀번호 해시와 두 개의 임의 비밀을 설정한 후 longhouse-server serve를 실행해야 합니다. 인증 없이 로컬 호스트 외부로 바인딩하는 것은 기본적으로 거부됩니다. Longhouse는 현재 사전 출시 단계로 활발히 개발 중이며, Apache-2.0 라이선스를 따르는 오픈 코어 프로젝트입니다. 월 5달러의 호스팅 옵션도 제공됩니다. 저장소에는 iOS 클라이언트가 포함되어 있어 사용자 입력이 필요할 때 APNs 푸시를 처리하지만, TestFlight나 앱 스토어 빌드는 제공되지 않습니다. 휴대폰에서 사용하려면 Xcode에서 하네스를 열어 기기에 직접 실행해야 합니다. 기여자는 저장소를 복제하여 make dev(핫 리로드 포함 로컬 UI), make dev-demo(데모 데이터 포함 격리된 백엔드), make test(단위 테스트), make test-e2e(엔드 투 엔드 테스트) 명령어를 사용할 수 있습니다. 웹 타임라인 UI, 추가 공급자 CLI 수집 파서, CLI 하위 명령 UX, 문서화 등이 주요 기여 분야입니다.