Agent skill

Lpm CLI

by gug007 in gug007/lpm

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 into standalone copies…

MITAuto-check passedAgent Workflows

Install Lpm CLI

skills CLI
$ npx skills add gug007/lpm --skill lpm-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gug007/lpm lpm-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gug007/lpm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/lpm-cli .claude/skills/lpm-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
lpm-cli
GitHub stars
152
Token cost
~1.4k tokens
SKILL.md length
750 words
Files
3
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

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 into standalone copies…

  • The user asks to operate
  • Calls git
  • Inspect lpm runtime state

What it does

Lpm CLI is an agent skill from gug007/lpm. 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 into standalone copies or create linked Git worktrees. Use when the user asks to operate or inspect lpm runtime state. LPMPROJECTNAME selects the default project after the skill triggers; it is not a trigger by itself. For editing YAML configuration, use lpm-config.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `README.md` and `agents/openai.yaml`).

It sits in Agent Workflows, covering Git worktrees. The repository describes itself as: Start, stop, and duplicate dev projects with one click. The best workspace for running Claude Code, Codex, and other AI agents alongside your services. The licence is MIT.

When your agent uses it

  • The user asks to operate
  • Inspect lpm runtime state

Example prompts

  • “/lpm-cli”

What it can do on your machine

Read from SKILL.md and the folder at commit 986226a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Lpm CLI loads about 1.4k tokens when it runs. Until then it costs about 114 tokens; SKILL.md has 750 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~114
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from gug007/lpm at commit 986226a, republished under its MIT licence (© gug007). 750 words, ~1,437 tokens.

Download SKILL.mdSave it as .claude/skills/lpm-cli/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
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 into standalone copies or create linked Git worktrees. 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`.
version
1.3.0

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.
  • config get, config apply, and control commands need the lpm app running; other inspection commands do not.
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).
  • In lpm list --json and lpm project --json, when isRemote is true, root is the project's ssh.dir: a path on the SSH host, not on this machine. Don't cd into it or read files there locally.
  • lpm config resolve [--cwd PATH] [--json] — match a directory to its deepest project root without using LPM_PROJECT_NAME. An SSH project matches only from its local sync mirror ~/.lpm/sync/<project-file-name>, never by root or ssh.dir.
  • lpm config validate <file> [--json] — validate syntax, fields, layer rules, and effective merged configuration.
  • lpm config get --layer project|repo|global|template [--project NAME | --template NAME] [--create] [--json] — read a config layer with the revision required for a safe write.
  • lpm config apply --layer project|repo|global|template [--project NAME | --template NAME] [--create] --if-revision HASH (--stdin | --file PATH) [--json] — validate a candidate and atomically apply it through the running app. Never edit a live config file directly.
  • 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] — create parallel working directories. Always pass a --label describing the copy's purpose so it's identifiable in the app — one repeated --label per copy in creation order, <project-name>-<short-description> style such as lpm-fix-auth. Only omit it when you genuinely can't infer a purpose. Output lists each copy's path.
  • lpm worktree [project] [-n N] [--label TEXT]... [--group X] [--run ACTION | --command CMD] [--prompt TEXT] [--reinstall-deps] — create linked Git worktrees instead of standalone copies. The same labeling guidance applies. Output lists each worktree's path.
  • lpm remove <copy-name> — remove a duplicate. For a linked worktree, this also removes its Git worktree registration and lpm-created branch. Originals and SSH projects (SSH duplicates too) need --force, and their folder is kept; 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.
Show full SKILL.md (263 more words)Show less
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.
Duplicate modes
  • lpm duplicate makes a standalone APFS copy. The app's duplicate setting decides whether uncommitted changes are copied; --include-uncommitted and --exclude-uncommitted override it.
  • lpm worktree makes a linked Git checkout with its own branch and shared repository data. The source must be a local Git repository, its lpm root must equal the repository root, and it must have at least one commit.
  • A worktree starts at the source's current HEAD on an lpm-created lpm/<copy-name> branch. It does not include uncommitted changes.
  • Remove worktrees with lpm remove; do not move, trash, or delete their folders directly.
  • If a standalone duplicate reports that the source is a linked Git checkout, retry with lpm worktree.
Fan-out (parallel agents)

lpm duplicate -n 3 --label <proj>-<purpose> --label <proj>-<purpose> --label <proj>-<purpose> --run <action> --prompt "..." clones the project into 3 labeled 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>.

Use lpm worktree for the fan-out when each copy should use an independent Git branch without duplicating repository data.

To create or edit project configs (services/actions/YAML), use the lpm-config skill.

© gug007, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in lpm-cli of gug007/lpm.

  • SKILL.md
  • README.md
  • agents/openai.yaml

Open the folder on GitHubat commit 986226a

Compare with similar skills

Lpm CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Lpm CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Lpm CLI this skillgug007/lpm152—~1.4kAutomated safety check: PassMIT
Orca CLIstablyai/orca87k2 repos~593Automated safety check: PassMIT
ClawTeam Multi-Agent Swarmwin4r/ClawTeam-OpenClaw1.5k1 repos~2.9kAutomated safety check: PassMIT
Using Git Worktreesjulianromli/opencode-template14428 repos~1.4kAutomated safety check: PassNone
Agent of Empires Session Manageragent-of-empires/agent-of-empires3.3k—~2.5kAutomated safety check: PassMIT
Huashu Agent Swarmalchaincyf/huashu-skills1.7k1 repos~576Automated safety check: PassMIT

Similar skills

  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    87k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed
  • ClawTeam Multi-Agent Swarm

    win4r/ClawTeam-OpenClaw

    Launches a swarm of specialist Hermes agents in git-worktree-isolated tmux windows with a kanban board and file-based inboxes, using built-in templates like hedge-fund and code-review.

    1.5k GitHub starsUsed in 1 repo~2.9k tokens
    Agent WorkflowsAuto-check passed
  • Using Git Worktrees

    julianromli/opencode-template

    A skill your agent uses when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory…

    144 GitHub starsUsed in 28 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Agent of Empires Session Manager

    agent-of-empires/agent-of-empires

    Launches, monitors and organizes AI coding agent sessions such as Claude Code or Codex inside tmux, tracking status, capturing output and managing git worktrees for parallel branches.

    3.3k GitHub stars~2.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Huashu Agent Swarm

    alchaincyf/huashu-skills

    多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。

    1.7k GitHub starsUsed in 1 repo~576 tokens
    Agent WorkflowsAuto-check passed
  • Nagent

    davidondrej/skills

    Launch a new bb worker thread with the right project, model, worktree, and task brief.

    4.1k GitHub stars~1.7k tokensUpdated today
    Agent WorkflowsAuto-check: notes

More from gug007/lpm

All 10 skills in this repo
  • Short

    gug007/lpm

    Make a short vertical (9:16) lpm lesson that feels native to TikTok, Reels and Shorts: a payoff-first hook, fast push-ins that follow the action, word-by-word burned-in captions, numbered step…

    152 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Short Game

    gug007/lpm

    Make a short vertical (9:16) video where two AI models build the same self-playing game in lpm, side by side, and both games then play live in lpm's browser.

    152 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Short Race

    gug007/lpm

    Make a short vertical (9:16) video that races two AI models on the same prompt in lpm, side by side: Run in duplicates puts each model in its own copy of the project, shown as side-by-side columns…

    152 GitHub stars~3.9k tokensUpdated today
    Auto-check passed
  • Lpm Config

    gug007/lpm

    Create and edit lpm YAML configs for projects, duplicates, worktree metadata, services, actions, header and footer button zones and zone layers, terminals, profiles, SSH projects, and shared config…

    152 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Short Publish

    gug007/lpm

    Post a finished vertical lesson from ~/Movies/lpm-lessons/tiktok/<slug/ to YouTube Shorts (LPM channel, through Chrome) and TikTok (@lpm06557, from the user's iPhone through iPhone Mirroring) in…

    152 GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Lesson

    gug007/lpm

    Make a narrated lesson video about lpm from the real desktop app, recorded on a pristine data directory.

    152 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Lpm CLI

What does Lpm CLI do?

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 into standalone copies…. Lpm CLI is an agent skill from gug007/lpm. 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 into standalone copies or create linked Git worktrees.

When should I use Lpm CLI?

Lpm CLI fits situations like: the user asks to operate; inspect lpm runtime state.

How do I install Lpm CLI in Claude Code?

Run `npx skills add gug007/lpm --skill lpm-cli -a claude-code`. Or copy the skill folder (lpm-cli in gug007/lpm) into .claude/skills/lpm-cli in your project. Claude Code loads it when a task matches its description.

How do I install Lpm CLI in Codex?

Run `npx skills add gug007/lpm --skill lpm-cli -a codex`. Or copy the skill folder (lpm-cli in gug007/lpm) into .agents/skills/lpm-cli in your project. Codex loads it when a task matches its description.

Can I use Lpm CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gug007/lpm --skill lpm-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lpm-cli, .gemini/skills/lpm-cli, .github/skills/lpm-cli and .opencode/skills/lpm-cli in your project.

What does Lpm CLI need to run?

Going by SKILL.md and its folder, Lpm CLI needs the command-line tools its instructions call (git).

Does Lpm CLI access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Lpm CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Lpm CLI use?

Lpm CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Lpm CLI use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Lpm CLI?

Skills that share tags, products or a category with Lpm CLI: Orca CLI (stablyai/orca, 87k stars), ClawTeam Multi-Agent Swarm (win4r/ClawTeam-OpenClaw, 1.5k stars), Using Git Worktrees (julianromli/opencode-template, 144 stars) and Agent of Empires Session Manager (agent-of-empires/agent-of-empires, 3.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Lpm CLI?

gug007 (a GitHub user) maintains it in gug007/lpm, which has 152 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 8, 2026.

Source: gug007/lpm on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.