Metadata-Version: 2.4
Name: lemma-terminal
Version: 0.4.2
Summary: Lemma CLI and terminal UI — build and operate Lemma pods, and install Lemma skills into your coding agent (Claude Code, Codex, OpenCode).
Author: Lemma
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/lemma-work/lemma-app
Project-URL: Repository, https://github.com/lemma-work/lemma-app
Project-URL: Documentation, https://github.com/lemma-work/lemma-app/tree/main/lemma-cli
Project-URL: Issues, https://github.com/lemma-work/lemma-app/issues
Keywords: lemma,cli,agents,pods,ai,skills,claude-code,codex,opencode
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: lemma-sdk>=0.4.2
Requires-Dist: click>=8.3.0
Requires-Dist: typer>=0.12.5
Requires-Dist: rich>=13.9.4
Requires-Dist: textual>=8.0
Requires-Dist: websockets>=14.0
Dynamic: license-file

# Lemma CLI (`lemma-terminal`)

`lemma` is the command-line and terminal-UI for [Lemma](https://github.com/lemma-work/lemma-app) —
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

```bash
uv tool install lemma-terminal
```

This installs the `lemma` command globally. (Don't have `uv`? See
[astral.sh/uv](https://astral.sh/uv).)

```bash
lemma --version
```

## Quickstart

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

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

```bash
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](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:

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

By default this 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:

| Target | Location (`--scope user`) | Tool |
|---|---|---|
| `claude` | `~/.claude/skills/` | Claude Code |
| `codex` | `~/.agents/skills/` | Codex CLI |
| `opencode` | `~/.config/opencode/skills/` | OpenCode |
| `agents` | `~/.agents/skills/` | shared (Codex + OpenCode) |
| `all` | all three above | — |

Use `--scope project` to install into the current directory (`.claude/skills/`, `.agents/skills/`,
`.opencode/skills/`), or `--dir PATH` for an arbitrary location. 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-admin`** — installs and manages the local Lemma stack (separate tool).

## License

Apache-2.0
