PM Pro

PM Pro is a VS Code/Code-OSS based MVP for product managers writing PRDs.

中文文档

The current implementation is a VS Code extension that can later be bundled as a built-in extension inside a Code-OSS desktop fork, matching the Cursor-style architecture: Electron desktop shell, VS Code workbench, and product-specific AI editing workflow layered on top.

MVP Flow

1. Open a workspace in VS Code or Code-OSS.
2. Create or open a Markdown PRD.
3. Put local context files under knowledge/.
4. Select text, or leave the selection empty for whole-document context.
5. Run PM Pro: Propose AI Edit.
6. Inspect the generated full-document diff.
7. Run PM Pro: Apply Proposal or PM Pro: Reject Proposal.
8. Save the Markdown PRD normally through VS Code.

AI Provider

The extension defaults to mock so the full diff/apply loop works without credentials.

Settings:

• pmpro.aiProvider: mock, claude-code, or codex-cli
• pmpro.claudeCommand: default claude
• pmpro.codexCommand: default codex
• pmpro.aiTimeoutMs: default 120000

Claude Code uses claude -p. Codex CLI uses codex exec.

Development

npm install
npm run build
npm test
npm run package
npm run package:desktop

The packaged extension is written to pmpro-0.1.0.vsix.

To run in a VS Code Extension Development Host, open this repo in VS Code and launch Run PM Pro Extension.

For the independent desktop product path, internal MVP builds can be distributed unsigned. See docs/internal-desktop-distribution.md for the certificate decision, expected platform warnings, and internal release checklist.

npm run package:desktop stages a Cursor-style desktop distribution under out/desktop/:

• out/desktop/extensions/ contains bundled third-party VSIX files. The PM Pro extension itself is not bundled for now.
• out/desktop/settings/default-settings.json contains product defaults, currently pointing PM Pro at Codex CLI.
• out/desktop/reports/agents-report.json records whether codex and claude are available on the build machine.
• out/desktop/macos/ and out/desktop/windows/ are the target locations for final Code-OSS/VSCodium installers.

Marketplace VSIX files are cached under .pmpro-cache/extensions/; repeated desktop packaging reuses the cached file unless it is missing or invalid.

To prepare a local Code-OSS/VSCodium source checkout with PM Pro branding and bundled third-party extensions:

VSCODE_DIR=/path/to/vscode npm run prepare:codeoss

This installs bundled third-party extensions, writes product.overrides.json, and stores desktop staging metadata under .pmpro/.