Command-line reference

Install status, login, workspace selection, vault operations, local media fetch, search, and MCP client setup.

Install

Authenticate, choose a workspace, manage vault content, search knowledge, and connect MCP-compatible clients from the terminal.

  • Homebrew (macOS / Linux) — brew install liquidlm/tap/liquidlm
  • Install script (macOS / Linux / WSL) — curl -fsSL https://liquidlm.com/install.sh | sh
  • npm (macOS / Linux / Windows) — npm install -g @liquidlm/cli

Sign in and inspect your session

Browser login stores a refreshable local session in ~/.liquidlm. Use whoami to confirm the active organization, bearer class, scopes, and visible vaults.

Switch workspaces explicitly when your account belongs to more than one organization.

liquidlm login
liquidlm whoami
liquidlm org list
liquidlm org use "Workspace name"
liquidlm org show

Vaults, uploads, and search

Vault commands accept an ID or label where noted. Upload accepts files or directories and recursively skips hidden files.

Hybrid semantic plus full-text retrieval is the default. Add --fulltext for lexical-only search or --json for machine-readable search output.

liquidlm vaults list
liquidlm vaults add ./research --label "Research"
liquidlm upload Research ./paper.pdf ./notes/
liquidlm search "What changed in the latest policy?"

Fetch media URLs locally

For hosts that block server-side downloads (notably YouTube), run yt-dlp on your machine. fetch always creates a note with the source URL and captions when available; pass --audio or --video to upload media into the vault.

Requires yt-dlp on PATH (and ffmpeg for --video). Use --cookies-from-browser or --cookies when the site asks you to sign in.

liquidlm fetch Research 'https://youtu.be/…' --notes 'standup clip'
liquidlm fetch Research 'https://youtu.be/…' --audio --cookies-from-browser chrome

Connect an MCP client

The recommended path writes a local stdio entry. The installed client launches the proxy under the hood and the CLI refreshes your session, so no token is stored in client config.

Supported client names are cursor, claude-code, codex, opencode, and generic. Restart the client after installation.

liquidlm mcp install --client cursor

Headless and CI setup

For environments without browser login, create a scoped API token in the app, expose it through LIQUIDLM_API_TOKEN, and install the direct HTTP configuration.

Keep the token outside repositories and scope it to only the actions and vaults the agent needs.

export LIQUIDLM_API_TOKEN="lqlm_..."
liquidlm mcp install --client cursor --pat

Agent instructions

Generate the current eight-tool LiquidLM instructions in a project without embedding a secret.

liquidlm skill

Current beta boundaries

The CLI covers login, identity, workspace selection, vault management, upload, local media fetch, search, token export, MCP client setup, and skill generation. It is not a multi-machine sync tool or an enterprise administration surface.

References