PopKit
Development workflows that actually work
Start each day knowing your project is healthy.
End each day with context saved for tomorrow.
Know exactly what to do next.
Get Started · Morning Routine · What's Next · Docs
What is PopKit?
PopKit organizes your Claude Code sessions around workflows, not tools.
Most AI coding assistants give you a prompt and say "figure it out." PopKit gives you:
It's the difference between "here's an AI" and "here's how to use AI to build software."
Command Tiers
PopKit intentionally exposes two layers:
| Layer | Prefix | Purpose | Default |
|---|
| Workflow commands | /popkit- | User-facing orchestration across commands, skills, and hooks | Yes |
| Direct skills | /pop- | Low-level primitives for targeted/advanced invocation | Advanced |
Example: /popkit-dev:next uses pop-next-action internally, then adds mode handling, reporting, and command-level guidance.
Get Started
Claude Code Plugin (recommended)
# Add the PopKit marketplace
/plugin marketplace add jrc1883/popkit-claude
# Install the plugins you need
/plugin install popkit-core@popkit-claude # Foundation
/plugin install popkit-dev@popkit-claude # Development workflows
# Restart Claude Code, then run your first morning routine:
/popkit-dev:routine morning
VS Code / Copilot (one-click install)
Requires pip install popkit-mcp first, then click the badge above.
PyPI (for MCP server or standalone use)
# MCP server only — for Cursor, Codex CLI, Copilot, or any MCP client
pip install popkit-mcp
popkit-mcp --transport stdio
# Full install — CLI + shared utilities + MCP server
pip install popkit[full]
# Or install individual packages
pip install popkit-shared # Core utilities only
pip install popkit-cli # CLI only
pip install popkit[mcp] # Core + CLI + MCP server
Morning Routine
Every morning, PopKit checks your project's vital signs:
/popkit-dev:routine morning
■ Session Restored
Last: Fixed authentication flow (2h ago)
■ Ready to Code Score: 87/100
✓ Git status clean
✓ Tests passing (142/142)
✓ CI green on main
⚠ 2 dependencies outdated
✓ No TypeScript errors
■ Context Loaded
Active issue: #47 Add password reset flow
Branch: feat/password-reset (3 commits ahead of main)
Ready to continue.
The "Ready to Code" score tells you if something needs attention before you start coding. 87 means you're good to go. 45 means something's broken.
What's Next
When you're not sure what to work on:
/popkit-dev:next
PopKit analyzes your git status, test results, GitHub issues, and TypeScript errors to recommend prioritized actions:
Recommended Actions:
1. Merge main into branch (Score: 85)
Branch is 5 commits behind main
2. Fix TypeScript error in src/auth.ts:47 (Score: 78)
Type 'string | undefined' is not assignable to type 'string'
3. Continue issue #47 (Score: 72)
Password reset flow - implementation started
4. Review PR #51 (Score: 65)
Dependency update, waiting 2 days
No more staring at your terminal wondering what to do.
Guided Development
Start a feature with /popkit-dev:dev:
/popkit-dev:dev "Add password reset via email"
jrc1883