Skip to content

CLI flags and environment (index)

Read this when…

You need an env var, migration flag, trace hub knob, or execute/MCP switch and want the repo-truth pointer.

What to know first: Appliance quick start for install and first boot.

Practical takeaway: This page is an index—single source of truth remains AGENTS.md on the branch you ship.

Release binaries

Binary Role Doc
plasm-server Appliance — HTTP/MCP host, TUI, embedded Postgres Quick start, CLI reference
plasm-mcp Standalone OSS HTTP + Streamable MCP host (-p plasm) Incoming auth, MCP persistence
plasm-pack-catalogs Pack apis/<name>/ → JSON IL + manifests for --catalog-dir Genco / catalog pipeline
plasm Remote HTTP terminal client Remote terminal
plasm-cgs One-shot compile + HTTP from dev checkout Start here
plasm-repl Interactive REPL against a backend Start here

Common appliance environment

Variable Role
DATABASE_URL / PLASM_MCP_CONFIG_DATABASE_URL Postgres for project_mcp_* (embedded autostart when unset on plasm-server)
PLASM_EMBEDDED_POSTGRES 0 disables embedded Postgres autostart
PLASM_EMBEDDED_POSTGRES_DATA_DIR Postgres cluster directory
PLASM_LOCAL_STATE_DIR Local state root (traces, run artifacts, bootstrap secrets). plasm-server defaults this to {appliance}/local when unset. Standalone plasm-mcp needs an explicit value (or specific archive dirs) for durable disk.
PLASM_TRACE_ARCHIVE_DIR Durable completed traces
PLASM_RUN_ARTIFACTS_DIR Filesystem run snapshots
PLASM_DISCOVERY_SEMANTIC_AUTO_SEED Intent-only plasm_context (appliance: also via Discovery TUI/CLI)
OPENROUTER_API_KEY OpenRouter key for semantic auto-seed
PLASM_APPLIANCE_DIAG_LOG Optional TUI diag log file path
AUTH_STORAGE_ENCRYPTION_KEY Encrypt OAuth secrets / MCP key material at rest

Full matrix: Surface inventory. Local durability details: Trace artifacts.

Authoritative lists (repository)

AGENTS.md (main branch) covers:

  • HTTP / MCP ports, --catalog-dir, --schema, execute Accept negotiation, MCP tools
  • Trace hub caps: PLASM_TRACE_HUB_*
  • Run artifacts: PLASM_RUN_ARTIFACTS_URL, retention and GC intervals
  • Incoming auth: PLASM_INCOMING_AUTH_MODE, PLASM_AUTH_JWT_SECRET

Links