Lightweight enhancement kits for spec-driven development.
lite-kits adds productivity-enhancing slash commands to spec-kit projects. Get smart git workflows (/commit, /pr, /cleanup), project orientation (/orient), code quality tools (/review, /audit, /stats), and optional multi-agent coordination.
It's an add-on, not a fork—your vanilla spec-kit stays vanilla, and you benefit from upstream updates automatically.
# Recommended: Install as a CLI tool with uv
uv tool install lite-kits
# Alternative: pipx (if you prefer pipx)
pipx install lite-kitsNote: Use
uv tool installorpipx installto install lite-kits as a CLI tool. These methods ensure thelite-kitscommand is available in your PATH. Regularpip install lite-kitsinstalls the package but may not add the CLI to your PATH on all systems.
cd your-spec-kit-project
# Add dev-kit (all solo development commands)
lite-kits add
# Check what was installed
lite-kits status# In Claude Code or GitHub Copilot
/orient # Get project context
/commit # Smart commit with staging
/pr # Create PR with auto-push
/review # Review staged changes
/cleanup # Clean up merged branches
/audit # Security analysis
/stats # Project metricsThat's it! See GUIDE.md for detailed command documentation and examples.
Dev-Kit (solo development):
/orient- Quick project orientation for AI agents/commit- Smart commits with staging proposals and conventional commits/pr- Pull request creation with auto-push and smart descriptions/review- Code review against best practices/cleanup- Safe merged branch cleanup/audit- Security analysis on dependencies and code patterns/stats- Project metrics and complexity analysis
Multiagent-Kit (optional, for multi-agent workflows):
/sync- Multi-agent coordination status- Collaboration directories and templates
- Memory guides (PR workflow, git worktrees protocol)
CLI Features:
- Beautiful terminal output with proper spacing
- Preview-first (see changes before applying)
- Smart auto-detection (agents and shells)
- File count summaries
helpcommand:lite-kits help [COMMAND]--forceflag to skip confirmations
lite-kits enhances GitHub spec-kit projects. You'll need:
-
Python 3.11+ - Download here
- Automatically checked by pip/uv during installation
-
Node.js & npm - Download here
- Required to install spec-kit (spec-kit is a Node.js package)
-
spec-kit - GitHub's spec-driven development framework (REQUIRED)
npm install -g @github/spec-kit
- lite-kits won't work without spec-kit initialized first
- Creates
.claude/or.github/prompts/directories where commands are installed
# 1. Install spec-kit (if not already installed)
npm install -g @github/spec-kit
# 2. Create a spec-kit project (or use existing)
specify init my-project
cd my-project
# 3. Install lite-kits as a CLI tool
uv tool install lite-kits # Recommended
# OR
pipx install lite-kits # Alternative
# 4. Add enhancement kits to your project
lite-kits add # Adds dev-kit (all commands)
# 5. Start using commands in your AI assistant
/orient # Get project context
/commit # Smart commit workflowWith pip (not recommended for CLI usage):
pip install lite-kits
⚠️ Warning:pip installinstalls the package but may not add thelite-kitscommand to your PATH on Windows. Useuv tool installorpipx installinstead for CLI tools.
From source:
git clone https://github.com/tmorgan181/lite-kits.git
cd lite-kits
uv build
uv tool install dist/lite_kits-*.whllite-kits commands work with any AI assistant that supports slash commands:
- ✅ GitHub Copilot (VSCode extension or CLI) - Native GitHub integration
- ✅ Claude Code (VSCode extension)
- ✅ Any assistant that reads
.mdprompt files
No additional configuration required—commands are just markdown files that your AI assistant reads.
# Kit management
lite-kits add # Add dev-kit
lite-kits add --kit dev # Add specific kit
lite-kits add --kit multiagent # Add multiagent-kit
lite-kits remove --all # Remove all kits
lite-kits remove --kit dev --force # Remove without confirmation
# Status and info
lite-kits status # Show installed kits
lite-kits validate # Verify installation
lite-kits info # Package information
lite-kits help [COMMAND] # Show help
# Global options
lite-kits --version / -V # Show version
lite-kits --banner # Show animated banner
lite-kits --quiet / -q # Suppress output
lite-kits --verbose / -v # Extra outputSee GUIDE.md for detailed documentation and examples.
Major rewrite with focus on modularity and UX:
- ✨ Manifest-driven architecture (zero hardcoded logic)
- 🔧 Modular installer (detector, validator, conflict_checker)
- 📦 Kit consolidation: project-kit + git-kit → dev-kit
- 🎨 Perfect terminal spacing and file count summaries
- 💬
helpcommand with optional command argument - ⚡
--forceflag for remove command - 🐛 Fixed all critical bugs (#1, #3, #4, #6, #7)
See CHANGELOG.md for full release notes.
- GUIDE.md - Complete command reference, workflows, and examples
- CHANGELOG.md - Version history and migration notes
- CONTRIBUTING.md - How to contribute
- manifest-schema.md - Technical reference for kits.yaml
Enhance, don't replace:
- lite-kits is an add-on for vanilla spec-kit (not a fork)
- Only adds files, never modifies spec-kit core
- Get upstream spec-kit updates automatically
- Modular kits (add/remove as needed)
Content-first structure:
kits/{kit-name}/commands/{command}.{agent}.md- Easy to add new commands, agents, and shells
- Single manifest (kits.yaml) as source of truth
Modular installer:
- Auto-detect agents (Claude, Copilot) and shells (Bash, PowerShell)
- Preview-first operations with conflict checking
- Clean separation of concerns across focused modules
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Contributing: See CONTRIBUTING.md
MIT License - see LICENSE for details.
Built to enhance GitHub Spec-Kit, a framework for spec-driven development with AI agents.
Status: Beta (v0.3.0) - Ready for production use
Philosophy: Enhance, don't replace. lite-kits adds features to vanilla spec-kit without forking or modifying core files.