PactKit offers two installation methods. Choose the one that fits your workflow.
Option A: Claude Code Plugin (Recommended)
The simplest way to install. No Python required.
# In Claude Code:
/plugin marketplace add pactkit/claude-code-plugin
/plugin install pactkitRestart Claude Code. All 9 agents, 13 commands, and 3 skills are immediately available.
| Update | Automatic via marketplace, or /plugin update pactkit |
| Uninstall | /plugin uninstall pactkit |
| Isolation | Plugin lives in its own cache directory, separate from ~/.claude/ |
| Team sharing | Add to .claude/settings.json — teammates get prompted to install |
The plugin deploys all components. For selective deployment (e.g., disable certain agents or commands), use the pip method with pactkit.yaml.
Team Sharing
Add the following to your project's .claude/settings.json to auto-prompt teammates:
{
"extraKnownMarketplaces": {
"pactkit": {
"source": { "source": "github", "repo": "pactkit/claude-code-plugin" }
}
},
"enabledPlugins": {
"pactkit@pactkit": true
}
}Option B: pip Install
For users who want fine-grained control via pactkit.yaml.
Requirements
- Python 3.10+
- Claude Code CLI installed and configured
Install
pip install pactkitDeploy
pactkit initThis deploys the complete toolkit to ~/.claude/:
| Path | Contents |
|---|---|
CLAUDE.md | Global constitution (references 6 rule modules) |
rules/ | 6 modular rule files |
agents/ | 9 agent definitions |
commands/ | 13 command playbooks |
skills/ | 3 skill tools with scripts |
Selective Deployment
Edit ~/.claude/pactkit.yaml to disable specific components, then re-deploy:
pactkit updateSee Configuration for details on pactkit.yaml.
Upgrade
pip install --upgrade pactkit
pactkit updateThe update command re-deploys all files. Your custom rules (files without managed prefixes like 01- through 06-) are preserved.
Other Commands
# Check version
pactkit version
# Preview to custom directory
pactkit init -t /tmp/preview
# Generate a standalone plugin directory
pactkit init --format plugin -t ./pactkit-plugin
# Generate a marketplace repository
pactkit init --format marketplace -t ./pactkit-marketplaceProject Initialization
After installing PactKit (via either method), initialize each project you work on:
/project-initThis creates the governance structure (docs/specs/, docs/product/sprint_board.md, docs/architecture/graphs/, etc.) in your project directory.
Forgot to initialize? No problem — /project-plan and /project-doctor automatically detect uninitialized projects and handle it for you.