GenPM README

Install architectures, not dependencies.
Code you own · Context your AI understands · MCP connections, ready.

GenPM injects complete modules — source code + AI rules + MCP servers — into your project from immutable Git commits. No opaque node_modules: the code lands in src/, versioned with yours, and your AI agent can read, change and extend it because every module ships the rules that explain how.

curl -fsSL https://genpm.net/install.sh | sh     # macOS / Linux
irm https://genpm.net/install.ps1 | iex          # Windows (PowerShell)

genpm add @core/auth

One native binary, no Node.js needed (genpm upgrade keeps it current). Also on Homebrew (brew install genpm-net/tap/genpm) and Scoop (scoop install genpm/genpm after scoop bucket add genpm https://github.com/GenPM-net/scoop-bucket). Prefer npm? npm i -g @genpm-net/cli or npx @genpm-net/cli … work too. More options: genpm.net/docs/install.

• Code lands in src/lib/auth, not in node_modules. You see it in your diff and you own it.
• Context: an AGENTS.md per module (plus Cursor, Copilot, Windsurf and Claude Code rule files), loaded only when your agent works in that folder.
• Connections: the MCP servers a module needs, added only with your consent.

See it working

Each demo repo has a step-by-step guide (online and PDF) and commits that show every step.

Start a new project

GenPM-net/saas-starter: a Next.js 16 template with GitHub login, Stripe subscriptions, plan gating and email already wired, built with genpm add. Use this template on GitHub, or npx degit GenPM-net/saas-starter my-saas.

Use it from your AI

genpm mcp setup                                  # writes the config for the AI clients it detects
claude mcp add genpm -- genpm mcp serve          # or register it by hand (Claude Code)

The MCP server is built into the genpm binary. Without it, use npx -y @genpm-net/mcp (needs Node.js).

Claude Code plugin (MCP server + a skill that tells Claude when to reach for GenPM):

claude plugin marketplace add GenPM-net/claude-plugin
claude plugin install genpm@genpm

Then ask: "Add GitHub login to this project with genpm." Your agent searches, shows you the plan and installs. Setup for Cursor, VS Code, Windsurf and Codex: genpm.net/docs/mcp.

Security

What you reviewed is what gets installed. Every package is pinned to a 40-character commit SHA and verified after download, manifests are signed by the registry, GenPM never runs package code or install scripts, writes stay inside your project, and AI rules are scanned for prompt injection. The ten invariants and how they are tested: docs/security.md · report a vulnerability: SECURITY.md.

Publish a package

genpm init && genpm validate
git tag v1.0.0 && git push --tags
genpm publish

Your code stays on GitHub; the registry stores metadata only. Guide: genpm.net/docs/publishing.

This repository

apps/
  registry/   API on Cloudflare Workers + Hono + D1 (metadata only)
  web/        genpm.net — Astro SSR on Cloudflare
packages/
  manifest/   @genpm/manifest — schema, canonical form, signatures, scanner (no I/O)
  core/       @genpm/core — resolve, fetch, plan, apply, inject, lockfile
  cli/        genpm — the CLI (thin facade over core)
  mcp/        @genpm-net/mcp — the MCP server (thin facade over core)
  i18n/       @genpm/i18n — ICU catalogs for en, es, pt-BR, fr, de, ja, zh-CN, ko
docs/         design and specs (Spanish)
tasks/        MVP plan and task board

Requirements to develop: Node 22.12+ (tsdown and Astro), pnpm 10, git 2.25+. The published genpm and @genpm-net/mcp run on Node 20.11+ (CI tests them on Node 20 and 22); the native genpm binaries are built with Bun (pnpm --filter @genpm-net/cli build:bin, ADR-025).

pnpm install
pnpm build && pnpm test      # every package
pnpm lint                    # Biome, hardcoded-text check, i18n catalogs, brand contrast
pnpm --filter @genpm/registry dev   # local registry on :8787
pnpm --filter @genpm/web dev        # genpm.net on :4321

Contributor rules (architecture, invariants, i18n) live in AGENTS.md; the technical design starts at docs/README.md.

License

The client packages (packages/*: genpm, @genpm-net/mcp, @genpm/core, @genpm/manifest, @genpm/i18n) are MIT-licensed. The registry (apps/registry) and the website (apps/web) are © GenPM, all rights reserved.