cli

openllmc — the OpenLLM CLI.

One compiled binary that carries every OpenLLM extension: a single MCPserver (openllmc mcp) exposing the full native gateway API (one toolper OpenAPI operation, generated from the same schema the gateway serves at/api/swagger), semantic code + docs search (claude-context), andpersistent cross-session memory (supermemory) — plus the hooksubcommands the openllm plugin's session hooks shell out to.

Self-contained by construction: the SDK is generated and committed(src/sdk/generated/) so this package links noprivate workspace code — it builds standalone from this repo.

Install

The canonical distribution is the compiled binary (verified against itspublished SHA-256). Installing the openllm plugin from your gateway'sdashboard installs it for you; standalone:

curl -fsSL "https://openllm.sh/api/setup/cli/install.sh" | bash
# ↑ also runs `openllmc setup` (PATH symlink + shell completion)
openllmc version
openllmc mcp            # the unified MCP server (stdio)

Installed from the dashboard (one-click)? That path runs sandboxed andskips PATH/completion — run ~/.openllm/bin/openllmc setup once.

Or consume the source as a package:

bun install github:openllmsh/cli # latest

Build from source

This repo is self-compilable — no private packages, no monorepo needed(the SDK is committed under src/sdk/generated/):

git clone https://github.com/openllmsh/cli && cd cli
bun install
bun run compile:host        # → dist/openllmc (this machine's target)
./dist/openllmc version     # v0.0.0-dev — source builds carry the dev sentinel
bun run compile             # all 4 targets: darwin/linux × arm64/x64 (+ .gz sidecars)

A source build bakes the 0.0.0-dev sentinel (release builds are stamped bythe release pipeline via --version), so it never self-updates — run itdirectly or point mcpServers.openllm at your dist/openllmc.

Commands

Config: LLM_GATEWAY_URL / LLM_GATEWAY_API_KEY (env, orthe shared ~/.openllm/.env — the same file thedaemon pairing writes, so OPENLLM_CLOUD_ORIGIN / OPENLLM_API_KEY apply toevery OpenLLM tool on the box).

Verify

Every published binary is pinned by SHA-256 in manifest.ts,committed to this repo. Confirm the artifacts the cloud serves are exactly whatthis source vouches for — no trust required:

bun install
bun run verify                        # download every published target, hash it, check vs manifest.ts
bun run verify -- --host              # just this machine's target
bun run verify -- --file ./openllmc   # a binary you already installed/downloaded
bun run verify -- --installed         # the `openllmc` on your $PATH

Exit code is 0 only when every checked binary matches its pinned digest.

Note: the binary is not byte-reproducible (bun build --compile --bytecode embeds non-deterministic bytecode), so rebuilding from sourcewon't hash-match the release. The verifiable guarantee is that thepublished asset matches the SHA-256 committed here — the same digestthe install script and openllmc self-update enforce on download.

License

Source-available under the Business Source License 1.1(© Quantide LLC) — converts to MIT on the Change Date. Not OSI open-source.

Read-only mirror. Regenerated from the OpenLLM monorepo each release.PRs welcome — ingested upstream with your authorship preserved. BUSLcontributions require the CLA (the bot will prompt you).