Skip to content

gug007/lpm

Repository files navigation

lpm — Local Project Manager

One click to start, stop, or duplicate your dev projects. Run Claude Code, Codex, and other AI agents in parallel on the same codebase — no conflicts, no context switching.

Website Release


Download lpm for macOS

A native macOS desktop app for managing your dev projects. Start, stop, duplicate, and switch between projects with a single click — with a built-in terminal optimized for AI coding agents like Claude Code and Codex.

  • Start and stop your entire project with a single click
  • Build fast with AI coding agents
  • The best terminal for AI agents like Claude Code and Codex
  • Duplicate your project instantly to build features in parallel —
    run multiple agents on the same codebase without conflicts
  • A single workspace for all your services, terminals, and agents
  • Switch between projects without losing context or running processes
  • Keep long-running tasks alive across sessions

Install

Download lpm from lpm.cx, open the .dmg, and drag lpm to Applications.

Supports macOS (Apple Silicon & Intel).

See it in action

Add a project — browse to a directory, define services, save

Adding a new project in lpm desktop app

Start a project — one click, live terminal output for every service

Starting a project in lpm desktop app

Run AI agents alongside your services — Claude Code, Codex, or any agent in the same workspace

Running Claude Code in lpm

Duplicate a project — work on features in parallel, no conflicts

Duplicating a project in lpm

Fast switching — stop one project, start another in seconds

Switching between projects in lpm

Split terminals — arrange services and agents side-by-side

Splitting terminals in lpm

Why lpm?

  • Native macOS app — GUI with live terminal, config editor, notes, and theme support
  • No Docker required — runs your services natively
  • Auto-detects project setup — Rails, Next.js, Go, Django, Flask, Docker Compose
  • Profiles for running service subsets
  • Actions — one-shot commands like tests, migrations, and deploys, runnable from the Actions button
  • Works with any stack — if it runs in a terminal, lpm can manage it
  • CLI + App in sync — same features, same state, mix and match freely

AI Agent Skill

lpm includes an agent skill that lets your AI coding agent create and manage lpm configs for you. Install it via skills.sh:

npx skills add gug007/lpm

Then just tell your agent "set up lpm for this project" and it will analyze your codebase, discover services, and write the config.

See lpm-config/README.md for details.

CLI

Prefer the terminal? lpm also ships with a CLI that shares the same config and state as the desktop app.

See README-CLI.md for install instructions, commands, and configuration reference.

About

Start, stop, and duplicate dev projects with one click. The best workspace for running Claude Code, Codex, and other AI agents alongside your services.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors