Lumen
Reference

CLI

Generated commands, options, and help text from the actual argparse parser.

Operate a Lumen environment.

Run commands from the repository root through the pinned Python environment:

uv run lumen --help

Global options

OptionTypeRequiredHelp
-h, --helpflagnoshow this help message and exit

Commands

lumen export-openapi

Regenerate the canonical OpenAPI document.

uv run lumen export-openapi

lumen import-agent-plugin

Import one reviewed, digest-pinned local Agent Plugins archive.

uv run lumen import-agent-plugin
ArgumentTypeRequiredHelp
--archivePathyesAbsolute path to the local Agent Plugins ZIP archive.
--archive-sha256stringyesExact archive digest as sha256:<64 lowercase hex characters>.
--source-namestringyesOpaque lowercase name for the reviewed local source.
--mcp-discoveryPathnoAbsolute path to a separately reviewed local MCP discovery report.
--mcp-discovery-sha256stringnoExact MCP discovery report digest as sha256:<64 lowercase hex characters>.

lumen init

Create the local development workspace and project.

uv run lumen init

lumen worker

Run Temporal and outbox worker loops.

uv run lumen worker
ArgumentTypeRequiredHelp
--onceflagnoDeliver current outbox work and exit.

On this page