Files
lumbridge-code/README.md
T

48 lines
1.8 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 product-definition phase. The current
binary is deliberately only a scaffold. We are validating the terminal engine,
UI stack, process/session model, ACP integration, packaging, and usage-data
contracts before committing to 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.
Start with [the product spec](docs/PRODUCT_SPEC.md),
[architecture](docs/ARCHITECTURE.md), and [research map](docs/RESEARCH.md).
## Scaffold
```bash
cargo test --workspace
cargo run -p lumbridge
```