About this project
Longhouse is an open-source tool that acts as a remote control and searchable timeline for coding agents. It does not replace the agent runtime; instead, it unifies the sessions you already run across providers and machines. You can watch live sessions from a web interface, search everything the agents have done, and send your next instruction while the agent keeps running in its real terminal on your machine.
Supported providers include Claude Code, Codex CLI, Cursor Agent, OpenCode, Antigravity, and Pi Agent. Each provider syncs into one searchable timeline. The level of remote control varies: for Claude Code and Codex, you can search, launch, interrupt, mid-turn steer, and resume. Cursor and OpenCode support search, launch, interrupt, and resume but not mid-turn steer. Antigravity supports search and launch but not interrupt, terminate, or reattach, and it will not start if its hook is not installed. Bare provider CLI sessions are still ingested into the timeline but remain unmanaged, meaning they are searchable and observable without Longhouse-owned remote control.
The architecture has two main components. The Machine Agent is a Rust engine that runs on each development machine and ships session events. The Runtime Host is a FastAPI application with a bundled web UI and SQLite storage, meant to live where durability is needed. On a laptop both can run together for trial use. For real durability, the Runtime Host can run on an always-on box such as a VPS, homelab, or Mac mini. The web UI is served at http://localhost:8080 by default.
Installation options include a macOS app, a shell installer for Linux, WSL, or Mac without the app, and a server installer for Runtime Host operators. The shell installer sets up the native pair. After installation, you authenticate with longhouse auth and can repair a configured machine with longhouse machine repair. Self-hosting the Runtime Host requires setting a password hash and two random secrets, then running longhouse-server serve. Binding beyond localhost without authentication is refused by default.
Longhouse is actively developed and currently pre-release. It is Apache-2.0 licensed with an open core; a hosted option is available for $5 per month. An iOS client exists in the repository and handles APNs push on needs_user, but there is no TestFlight or App Store build and no IPA in any release. To use it on a phone today, you open the Xcode harness in Xcode and run it onto your own device.
Contributors can clone the repository and use make dev for local UI with hot reload, make dev-demo for an isolated backend with seeded demo UI, make test for unit tests, and make test-e2e for end-to-end tests. Good entry points include the web timeline UI, additional provider-CLI ingest parsers, CLI subcommand UX, and documentation.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.