| name | lpm-cli |
| description | Operate lpm-managed projects through the `lpm` CLI: start or stop projects and services, inspect logs and agent status, wait for readiness, run actions, and duplicate projects for parallel work. Use when the user asks to operate or inspect lpm runtime state. `LPM_PROJECT_NAME` selects the default project after the skill triggers; it is not a trigger by itself. For editing YAML configuration, use `lpm-config`. |
lpm is a command-line companion to the lpm desktop app. Verify it is available with lpm --version; if it is missing, install it from the lpm app's Settings.
Key facts
- The project name is inferred from
LPM_PROJECT_NAME or the current directory — omit it inside lpm terminals.
- Default output is compact text (cheapest); add
--json only when you need to parse the result.
- Exit codes:
0 ok, 2 usage / not found / app not running, 1 failure / timeout.
- Control commands (everything except the read commands) need the lpm app running.
Commands
lpm list — all projects, running state, agent counts.lpm project [name] [--full] — one project in full (--full adds env maps, action details, terminal history).lpm config resolve [--cwd PATH] [--json] — match a directory to its deepest project root without using LPM_PROJECT_NAME.lpm config validate <file> [--json] — validate syntax, fields, layer rules, and effective merged configuration.lpm logs [service] [-n 30] [-p proj] — service scrollback, exactly N lines.lpm status [project] — live agent statuses (Running/Waiting/Done/Error).lpm start [project] [--profile X] / lpm stop [project] — start / stop a project's services.lpm service <name> start|stop|restart [-p proj] — one service.lpm wait [project] [--service X | --port N | --agent] [--timeout 60] — block until ready; --agent waits for the project's agents to settle.lpm duplicate [project] [-n N] [--label TEXT]... [--group X] [--run ACTION | --command CMD] [--prompt TEXT] [--include-uncommitted | --exclude-uncommitted] — clone into parallel copies; repeated labels apply to copies in creation order, using <project-name>-<short-description> labels such as lpm-fix-auth. Output lists each copy's path. By default the app's duplicate setting decides whether uncommitted changes are copied; the two flags override it for this run.lpm remove <copy-name> — duplicates only; originals need --force (don't use --force unless the user explicitly asks).lpm run [action | --command CMD] [--prompt TEXT] [-p proj] — queue in a new app terminal, fire-and-forget.lpm set-status <key> <value> / lpm clear-status <key> — report status to the app UI.
Token rules
- After
lpm start, use lpm wait — never a sleep or poll loop.
- After queueing agent work, use
lpm wait --agent -p <copy> --timeout N instead of polling lpm status in a loop.
- Read logs with a small
-n first (e.g. -n 30); increase only if needed.
- Errors already name the fix — unknown project/service errors list the valid names. Read the error before retrying.
Fan-out (parallel agents)
lpm duplicate -n 3 --run <action> --prompt "..." clones the project into 3 auto-named copies and queues the task in each. Then, per copy: lpm wait --agent -p <copy> until it settles, review its work at the printed path (e.g. git diff there), and lpm remove <copy>.
To create or edit project configs (services/actions/YAML), use the lpm-config skill.
