Lemma CLI (lemma-terminal)

lemma is the command-line and terminal-UI for Lemma — build and operate pods (a team's tables, files, functions, agents, workflows, schedules, connectors, surfaces, and apps) from your terminal, and drop Lemma's agent skills straight into your coding agent so it can build pods for you.

Install

uv tool install lemma-terminal

This installs the lemma command globally. (Don't have uv? See astral.sh/uv.)

lemma --version

Quickstart

lemma auth login            # authenticate against the default cloud server
lemma orgs select --save-default   # pick your organization
lemma pods select --save-default   # pick the pod to work in
lemma describe              # inventory the selected pod

From there, the command surface mirrors the resource model — lemma <resource> <verb>:

lemma tables list
lemma files ls /knowledge
lemma agent chat            # talk to the pod's default agent
lemma pod init my-pod       # scaffold a new pod bundle on disk to import

Add --json to any command for machine-readable output, and --full to expand folded fields. See SETUP.md for cloud/local server configuration, environment variables, and the Textual TUI (lemma tui).

Install Lemma skills into your coding agent

Lemma ships agent skills (SKILL.md format) that teach a coding agent how to design, build, and operate pods. lemma skills installs them into the coding agent you already use:

lemma skills list                       # what's bundled
lemma skills install                    # auto-detect Claude Code / Codex / OpenCode / Cursor and install
lemma skills install --target claude    # or pick one explicitly
lemma skills install --all-skills       # include browser + liteparse-documents too

install is an upsert — the CLI owns these skills, so an existing copy is overwritten to match what this lemma-terminal bundles (re-run it after upgrading to refresh them; identical copies report unchanged). By default it installs the curated set — lemma-builder, lemma-user, lemma-widget — at the user level so it's available across all your projects. Targets and their locations:

Use --scope project to install into the current directory (.claude/skills/, .agents/skills/, .opencode/skills/, .cursor/skills/), or --dir PATH for an arbitrary location. Cursor is project-scoped only — run lemma skills install --target cursor --scope project inside the repo you're working in. Then restart your coding agent and ask it to build a pod.

How it fits together

• lemma-sdk — the Python client used by functions and automation.
• lemma-terminal (this package) — the human- and agent-facing CLI and TUI; pod-scoped workflows are first-class.
• lemma-stack — installs and manages the local Lemma stack (separate tool).

License

Apache-2.0