popkit-core

PopKit

---

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:

• Morning routines that check your project health before you write code
• "What's next?" recommendations based on your actual git status, failing tests, and open issues
• Guided development that walks you through feature implementation phase by phase
• Session capture so you can pick up exactly where you left off

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-ai

# Install the plugins you need
/plugin install popkit-core@popkit-ai   # Foundation
/plugin install popkit-dev@popkit-ai    # 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"