popkit-ai

workflow
Security Audit
Warn
Health Warn
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This workflow automation suite provides structured development routines, session capture, and guided feature implementation for Claude Code and VS Code Copilot. It acts as an orchestration layer, organizing AI coding sessions around daily workflows rather than isolated tool usage.

Security Assessment
The automated code scan of 12 files found no dangerous patterns, hardcoded secrets, or malicious obfuscation. No dangerous permissions are requested during installation. Because this is a development workflow tool, it inherently interacts with local project files, git status, and terminal commands to execute its routines. It also requires installing a Python package via `pip` and makes external network calls (e.g., to its documentation site). Given the scope of what it does, the overall risk is rated as Low.

Quality Assessment
The project is very actively maintained, with its most recent push occurring today. It features clear, professional documentation and a two-tiered command structure that indicates thoughtful design. However, community trust and visibility are currently very low. The repository only has 5 stars, meaning it has not yet been widely vetted by a large audience. Additionally, the project uses a "NOASSERTION" license, meaning the exact terms of use and redistribution are legally undefined.

Verdict
Safe to use, but be aware of the unproven community track record and undefined software license before adopting it in enterprise environments.
SUMMARY

AI-powered development workflow automation for Claude Code. Modular plugin suite with 23 commands, 38 skills, and 22 specialized agents for professional software development.

README.md

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)

Install in VS Code Install in VS Code Insiders

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"

PopKit walks you through seven phases:

  1. Discovery — What exactly are we building?
  2. Exploration — What patterns exist in this codebase?
  3. Questions — What do we need to clarify before coding?
  4. Architecture — How should we structure this?
  5. Implementation — Write the code, phase by phase
  6. Review — Check what we built
  7. Summary — Document what changed

Each phase has checkpoints. You approve before moving forward.


Nightly Routine

End your day with context saved:

/popkit-dev:routine nightly
■ [Sleep Score](https://popkit.unjoe.me/features/routines/#nightly-routine): 92/100

  ✓ All changes committed
  ✓ Branch pushed to origin
  ✓ Tests passing
  ✓ No uncommitted stashes
  ✓ Session branches clean

■ Session Captured
  Work: Implemented password reset email flow
  Next: Add reset token validation endpoint

■ Dependencies
  2 security updates available (non-breaking)

Sweet dreams.

Tomorrow's morning routine will restore this context automatically.


The Philosophy

PopKit tries to be programmatic where possible, AI where needed.

Approach What it means
Programmatic git Status checks are scripts, not AI guesses
Rule-based validation TypeScript errors come from tsc, not prompts
Explicit state Session context is JSON, not memory
AI for judgment Architecture decisions, code review, prioritization

This reduces token usage, makes workflows reproducible, and keeps AI focused on what it's actually good at.


Parallel Development

Work on multiple features simultaneously with worktree management:

/popkit-dev:worktree list

PopKit adds batch operations and health analysis on top of git worktrees:

  • update-all — Pull latest changes across all worktrees at once
  • analyze — Get recommendations for stale worktrees, uncommitted changes
  • init — Auto-create worktrees from branch patterns

No more manual worktree juggling when you're working on multiple features.


More Plugins

PopKit is modular. Install what you need:

Plugin What it adds
popkit-core Project setup, Power Mode (multi-agent), session management
popkit-dev Git workflows, worktrees, routines, /next recommendations
popkit-ops Quality assessments, security scanning, debugging, deployment pipeline
popkit-research Knowledge capture, research notes, documentation sync
/plugin install popkit-ops@popkit-claude      # Quality & security
/plugin install popkit-research@popkit-claude # Knowledge management

Requirements

  • Claude Code 2.1.33+ (tested through 2.1.80)
  • Python 3.11+
  • Git
  • GitHub CLI (gh) for GitHub integration

Documentation


Status

Version: 1.0.0-beta.12
Status: Public beta — core features stable, actively improving


License

PolyForm Noncommercial 1.0.0 — see LICENSE

This software is free for personal, educational, and noncommercial use.


Reviews (0)

No results found