Installation
PP Core installs in a single command and adapts itself to whichever AI coding runtime you use. This page covers what you need beforehand, how to install, which platforms are supported, and how to verify and update your setup.
Prerequisites
PP Core runs on Node.js and is distributed through npm, so you need both available on your machine:
- Node.js version 22.0.0 or newer
- npm version 10.0.0 or newer
Check your versions before installing:
node --version
npm --version
If either is missing or out of date, install or upgrade Node.js (which bundles npm) from your platform's package manager or the official installer.
Installing
The recommended way to install is with npx, which always pulls the latest published release of the pp-core package:
npx pp-core@latest
Run this from anywhere. The installer detects your environment, asks which runtimes to target if needed, and writes the slash commands and configuration into place. No manual file editing is required.
Install Flags
You can target specific runtimes and choose an install scope directly from the command line:
| Flag | Effect |
|---|---|
--claude | Install commands for Claude Code |
--gemini | Install commands for Gemini CLI |
--codex | Install commands for Codex |
--cursor | Install commands for Cursor |
--cline | Install commands for Cline |
--all | Install for every supported runtime |
--global | Install commands user-wide, available in any project |
--local | Install commands into the current project only |
For example, to install the Claude Code commands globally:
npx pp-core@latest --claude --global
Supported Platforms
PP Core works across a broad set of AI coding runtimes. Command prefixes differ slightly between them, so the same action is invoked a little differently depending on where you run it:
| Runtime | Command prefix | Example |
|---|---|---|
| Claude Code, GitHub Copilot, OpenCode, Kilo | /pp- | /pp-new-project |
| Cursor | /pp- | /pp-new-project |
| Cline | /pp- | /pp-new-project |
| Gemini CLI | /pp: | /pp:new-project |
| Codex (0.130.0 or newer) | $pp- | $pp-new-project |
Throughout the rest of the documentation, commands are written with the /pp- prefix. Translate to your runtime's prefix as needed.
Verifying the Install
The simplest check is to start a project. Open your AI runtime in any directory and run the initialization command:
/pp-new-project
On Gemini CLI, use /pp:new-project instead. If PP Core responds and begins gathering project context, the install succeeded and the commands are wired up correctly.
Updating
Because PP Core is installed with npx ... @latest, re-running the install command fetches and applies the newest release:
npx pp-core@latest
You can also update from inside your runtime, and opt into the latest pre-release build with the --next flag:
/pp-update --next
Re-running the installer is safe to do at any time; it refreshes the command definitions without touching your project's .planning/ artifacts.