Files
LLeMbas-Desktop/README.md
T
HomerandClaude Opus 5.5 daf2cf31ce
ci / check (push) Failing after 3s
LLeMbas's own window, the leaf icon, one name for the app
- The window has no system decoration: a local title bar webview (agent
  state, a native menu with the tray's items, window buttons) above the
  content webview, which stays remote with no IPC. Laid out on resize,
  with a frame to resize by unless maximized.
- Icons from the transparent pixel leaf, not the server's tiled icon.
- productName llembas-desktop: package, .desktop file and the window's
  app id now match (KWin showed a generic icon); the visible name stays
  LLeMbas through a desktop template. Replaces the 0.1.0 package l-le-mbas.
- The bundled CLI is a resource in the app's own directory, not
  /usr/bin/lembas.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-14 15:54:55 +00:00

2.7 KiB

LLeMbas Desktop

Your LLeMbas server in a window of its own, with the agent on this computer.

  • The whole web UI: chats, agent chats, the library, reports, settings. Same account, models, permissions and credits as in the browser; the app is a front end to the server you already run.
  • The agent, built in. LLeMbas Desktop carries the LLeMbas CLI and runs it in the background as this computer's device, so agent chats started on the server can work in your projects here, without a terminal.
  • Its own window: a LLeMbas title bar with the agent's state and a menu (start and stop the agent, link the computer, reload, change server, quit). Close the window and the agent keeps running in the tray, which has the same menu.

Alpha. Linux first (.deb and AppImage, x86-64). Windows and macOS later.

Install

Download the .deb or the AppImage from the latest release. Check it against SHA256SUMS in the same release.

sudo apt install ./llembas-desktop_*_amd64.deb      # Debian, Ubuntu (replaces 0.1.0's l-le-mbas)
chmod +x llembas-desktop_*.AppImage && ./llembas-desktop_*.AppImage

On GNOME the tray needs the AppIndicator extension; without it, the title bar's menu has everything, and starting the app again brings a hidden window back.

Use

  1. Start LLeMbas and enter your server's address. Sign in there as you would in a browser.
  2. From the tray, Link this computer. The approval page opens in the window; approve it.
  3. The agent starts. In the server's new-chat screen, choose this computer for an agent chat.

The agent is the LLeMbas CLI's lembas service, using the CLI's own configuration (~/.config/lembas). The app's copy of the CLI lives in its own directory (/usr/lib/llembas-desktop/), not on your PATH. If you also installed the CLI and run lembas service yourself, the app sees it and does not start a second one: they are the same device.

Build

Needs Rust (stable) and, on Linux, WebKitGTK 4.1 and an AppIndicator library:

sudo apt install libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev libxdo-dev
scripts/fetch-cli.sh                 # the bundled CLI, checked against its release signature
cargo install tauri-cli --version "^2" --locked
cargo tauri dev                      # or: cargo tauri build

There is no Node and no bundler: the app's one local page is plain HTML, CSS and JavaScript in ui/. Everything else on screen is the server's own web UI. The version of the CLI it carries is in lembas-cli.version.

Licence

MIT; see LICENSE. The bundled LLeMbas CLI is MIT too, with its own third-party notices.