Quickstart

Add your first module in about a minute. You only need git 2.25+ (without it, GenPM falls back to GitHub tarballs).

1. Install genpm

macOS and Linux:

curl -fsSL https://genpm.net/install.sh | sh

Windows (PowerShell):

irm https://genpm.net/install.ps1 | iex

It is a single binary, no Node.js needed. Other options (npm, a specific version, mirrors) are in Install.

2. Add a package

Run this in the root of your project. GenPM shows the full plan and asks before writing anything.

genpm add @core/auth

GenPM resolves @core/auth and its dependency @core/db, verifies the registry signature of each manifest, downloads the exact commit and scans it locally before showing you the plan.

3. See what changed

git status

• The code is in src/lib/auth and src/lib/db — it is your code now.
• The rules your AI reads are in src/lib/auth/AGENTS.md.
• genpm.lock pins every package to a 40-character commit SHA.
• .env.example lists the variables to configure (names only, never values).

4. Let your AI take over

Open your agent and ask it to wire the module in. It reads the module rules and follows their Integration section:

Integrate @core/auth following src/lib/auth/AGENTS.md. Add GitHub login.

Connect the MCP server and your agent can do step 1 too.