Repository navigation
LumenBox 0.2.0 — the first release for anyone
LumenBox 0.2.0 — the first release for anyone
The first build meant for a person who has never seen the project: a macOS app, a getting-started
guide, and a way to bring a box of your own.
Install on macOS
Download LumenBox-0.2.0-arm64.dmg (Apple Silicon), open it, drag LumenBox to Applications. An
Intel build is not in this release: the toolchain's download of the Intel runtime kept aborting on
the release machine; it follows as 0.2.1 when it builds.
The app is signed with a Developer ID but not notarized. Gatekeeper will say it cannot be
checked. Do one of:
- right-click the app in Applications → Open → Open (once), or
- in Terminal:
xattr -dr com.apple.quarantine /Applications/LumenBox.app
Then it opens normally. It needs a model key (Settings asks) and a box: Docker Desktop or
OrbStack on this Mac, Docker on another machine, or a Grok Bot's box through the
LumenBox Bridge template. Everything is in
Getting started.
What is in it
- A team of agents with their own desktops, browsers and shells in one Linux box; watch and
take over any desktop. - Feishu and DingTalk as chat surfaces, with cards, files and button approvals.
- Memory in plain files; skills in
SKILL.mdfolders; bot templates that pack and share. - The turn engine minds the person: the opening line reaches the chat while tools run, read-only
tools run in parallel, a verdict from memory is sent back to check. - Forks and delegated jobs survive a restart; delegated engines can be lent host MCP tools
without a credential entering the box; hot-reloadable extensions. - Launch at login.
Also in this release
lumen-dropin.tar.gz— the box daemon and its desktop scripts, for a box that is not a Docker
container of ours (a Grok Bot's VM, any Linux machine).lumen-bridge.sh— the installer a Grok Bot runs from the Bridge template, or you run yourself.
Known limits
- Apple Silicon macOS only in this release; Intel next, Windows and Linux builds are unproduced.
- Not notarized (see above).
- The Docker box image is pulled on first start and is large; the first Start the box takes minutes.