Files
LLeMbas-CLI/README.md
T
HomerandClaude Opus 5.5 28ff205ed0 Custom connections are gone: the CLI talks to the LLeMbas server it is logged in to
LLeMbas CLI 2.0 is LLeMbas-server-specific (CLI rule 2). Removed: the
anthropic, gemini, ollama and responses clients, context discovery and
llama-swap unloading (discover.ts), the Connection schema with its dialect,
auth, key_cmd, discover, unload_url and one_model_at_a_time, the model
`fallback` (it only ever moved to another server), effort_map and cache, and
the multi-connection refs. Kept: openai-chat, http, sse, think, effort,
tokens and all of src/lembas.

- connections.yaml holds the login (`type: webui`, as lembas login writes
  it). A custom entry from 1.x is read past with a warning that says how to
  log in, so an old file still starts; with several logins left, the latest
  is used and the others named.
- A model's ref is the id the server serves it under; the older forms
  (`<login>/<id>`, `<login>/<model>`) still resolve and config.yaml is
  rewritten once. Without a login there is no model, and the error (and the
  first-run screen, now the sign-in alone) says `lembas login <address>`.
- A login to another server signs this machine out of the previous one.
- The window is the server's word (no discovery); a capacity group comes
  from the server's `capacity.group` alone; embeddings use the server's
  /v1/embeddings.
- `lembas models` lists the server's models; install.sh's starter files, the
  README and the JSON schemas say the same.

Tests: every fixture is a login now (the fake server lists models, answers
other GETs with 404, and can hand one model to another script, as a server
with several backends); the dialect suites and the cross-connection tests are
gone with their code.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 21:00:05 +00:00

45 lines
1.6 KiB
Markdown

<p align="center">
<img src="assets/banner.svg" alt="LLeMbas CLI — terminal coding agent" width="100%">
</p>
# LLeMbas CLI
A terminal coding agent and project manager: the `lembas` command. It signs in to a
[LLeMbas](https://github.com/LLeMbas/LLeMbas) server and uses its models, memory and search, works
in your project with four permission modes and a git snapshot of every turn, keeps its own notes,
knowledge bases and skills on your machine, and lets the server's web UI work the same sessions.
Linux, x64 and arm64.
## Install
```sh
curl -fsSL https://github.com/LLeMbas/LLeMbas-CLI/releases/latest/download/get.sh | bash
```
Or download a binary from [Releases](https://github.com/LLeMbas/LLeMbas-CLI/releases). Every
release's `SHA256SUMS` is signed with the release key, and `get.sh` checks the signature and the
checksum before installing anything ([SECURITY.md](SECURITY.md) shows how to check by hand).
## First steps
```sh
lembas login https://your-server # sign in to your LLeMbas server
cd your-project && lembas # the TUI, on the server's models
```
From 2.0 the CLI talks only to the LLeMbas server it is logged in to; the custom connections of 1.x
(`dialect:` entries in `connections.yaml`) are gone.
`lembas` updates itself (`lembas update` does it now); `lembas uninstall` removes it, and
`--purge` takes settings and sessions too.
## Links
- Documentation: <https://llembas.eu/cli.html> and <https://llembas.eu/docs/>
- Changelog: <https://llembas.eu/changelog.html>
- The server: <https://github.com/LLeMbas/LLeMbas>
## Licence
MIT — see [LICENSE](LICENSE) and [THIRD_PARTY.md](THIRD_PARTY.md).