73 lines
3.5 KiB
Markdown
73 lines
3.5 KiB
Markdown
# Lumbridge
|
||
|
||
Lumbridge is a fast, local-first workspace and terminal multiplexer for agentic
|
||
engineers. It will run coding harnesses side by side, preserve their sessions,
|
||
connect rich agents through ACP, and show trustworthy account and usage context
|
||
without forcing users into one model vendor.
|
||
|
||
The first supported desktop platforms are:
|
||
|
||
- macOS (Apple Silicon first, Intel when CI capacity is available)
|
||
- Ubuntu Linux
|
||
- Omarchy and compatible Arch Linux systems
|
||
|
||
Lumbridge is free and open source under Apache-2.0. Releases will be published
|
||
as installable binaries; building from source will remain supported.
|
||
|
||
## Status
|
||
|
||
This repository is in architecture and vertical-slice phase. The installable
|
||
binary is still a scaffold, while the isolated native UI spikes now exercise an
|
||
interactive 3×1 workspace backed by six live comparison surfaces and the root workspace contains the first
|
||
bounded local PTY, runtime-actor, VT engine, and capability-gated workspace
|
||
command boundaries. The GPUI slice renders one styled actor-owned VT session in
|
||
the primary 60% work band while five deterministic surfaces keep updating in the
|
||
background. We are still validating selection/scrollback rendering, standalone
|
||
runtime IPC/durability, ACP integration,
|
||
packaging, and usage-data contracts before a large implementation.
|
||
|
||
## Product shape
|
||
|
||
- A native desktop shell with tabs, panes, workspaces, worktrees, diffs, and an
|
||
agent-aware footer.
|
||
- A Rust session runtime that survives UI restarts and can later run headless.
|
||
- ACP-native integrations where available, with supervised PTYs as the universal
|
||
fallback for any CLI harness.
|
||
- First-class harnesses for Claude Code, Codex, DeepSeek Harness, Pi, Hermes,
|
||
OpenClaw, Goose, Gemini CLI, and OpenCode.
|
||
- Subscription login owned by the upstream harness, plus separate BYOK provider
|
||
profiles for OpenAI, Anthropic, Gemini, Groq, Cerebras, DeepSeek, and more.
|
||
- Usage history, burn rate, reset windows, and forecasts with visible data
|
||
provenance instead of invented precision.
|
||
- Optional first-class Buzz channels, messages, agents, and confirmed redacted
|
||
pane sharing without making Buzz a requirement.
|
||
- An optional Lumbridge Harness that can suggest, coordinate, and—with explicit
|
||
execution capability—manage agents through the same audited command plane as
|
||
the human UI. Lumbridge remains useful without it.
|
||
|
||
Start with [the product spec](docs/PRODUCT_SPEC.md),
|
||
[architecture](docs/ARCHITECTURE.md), [research map](docs/RESEARCH.md), and
|
||
[captured upstream revisions](docs/RESEARCH_SNAPSHOTS.md). The native UI choice
|
||
is intentionally open; see [the measured decision plan](docs/UI_OPTIONS.md).
|
||
|
||
## Scaffold
|
||
|
||
```bash
|
||
bacon # continuous check; t tests, c lints, v runs the full gate
|
||
cargo xtest # fast isolated tests with nextest
|
||
./scripts/ci.sh # format + strict Clippy + tests + doctests
|
||
cargo run -p lumbridge
|
||
```
|
||
|
||
See [the testing strategy](docs/TESTING.md) for fake harnesses, ACP replay,
|
||
terminal conformance, UI driving, recovery, performance, and packaging tests.
|
||
|
||
The accepted local/remote boundary is recorded in
|
||
[decision 0003](docs/decisions/0003-local-data-and-remote-sessions.md). The two
|
||
native shell candidates live in [`spikes/`](spikes/), with results tracked in
|
||
[the UI scorecard](docs/UI_SPIKE_SCORECARD.md).
|
||
The signed-protocol and pane-sharing boundary is in
|
||
[the Buzz integration design](docs/BUZZ_INTEGRATION.md).
|
||
Brand masters, platform-ready raster exports, and usage rules are in
|
||
[`assets/brand/`](assets/brand/) and [the brand guide](docs/BRAND.md).
|