# 🌈 LITE-KITS 🎒
[](https://pypi.org/project/lite-kits/)
[](https://www.python.org/downloads/)
[](https://github.com/astral-sh/uv)
[](https://github.com/github/spec-kit)
[](https://opensource.org/licenses/MIT)
**Lightweight enhancement kits for spec-driven development.**
<img width="750" height="450" alt="lite-kits banner in terminal" src="assets/banner.gif" />
## What is this?
**lite-kits** adds productivity-enhancing slash commands to [spec-kit](https://github.com/github/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.
## Quick Start
### 1. Install lite-kits
```bash
# Recommended: Install with uv
uv tool install lite-kits
# Or with pip
pip install lite-kits
```
### 2. Add kits to your spec-kit project
```bash
cd your-spec-kit-project
# Add dev-kit (all solo development commands)
lite-kits add
# Check what was installed
lite-kits status
```
### 3. Use the commands
```bash
# 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 metrics
```
That's it! See [GUIDE.md](docs/GUIDE.md) for detailed command documentation and examples.
## Features
**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
- `help` command: `lite-kits help [COMMAND]`
- `--force` flag to skip confirmations
## Installation
### Prerequisites
lite-kits enhances GitHub spec-kit projects. You'll need:
1. **Python 3.11+** - [Download here](https://www.python.org/downloads/)
- Automatically checked by pip/uv during installation
2. **Node.js & npm** - [Download here](https://nodejs.org/)
- Required to install spec-kit (spec-kit is a Node.js package)
3. **spec-kit** - GitHub's spec-driven development framework (REQUIRED)
```bash
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
### Complete Installation Flow
```bash
# 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
uv tool install lite-kits # Recommended: with uv
# OR
pip install lite-kits # Alternative: with pip
# 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 workflow
```
### Alternative Install Methods
**With pip:**
```bash
pip install lite-kits
```
**From source:**
```bash
git clone https://github.com/tmorgan181/lite-kits.git
cd lite-kits
uv build
uv tool install dist/lite_kits-*.whl
```
### AI Assistant Compatibility
lite-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 `.md` prompt files
No additional configuration required—commands are just markdown files that your AI assistant reads.
## CLI Commands
```bash
# 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 output
```
See [GUIDE.md](docs/GUIDE.md) for detailed documentation and examples.
## What's New in v0.2.0
**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
- 💬 `help` command with optional command argument
- ⚡ `--force` flag for remove command
- 🐛 Fixed all critical bugs (#1, #3, #4, #6, #7)
See [CHANGELOG.md](CHANGELOG.md) for full release notes.
## Documentation
- **[GUIDE.md](docs/GUIDE.md)** - Complete command reference, workflows, and examples
- **[CHANGELOG.md](CHANGELOG.md)** - Version history and migration notes
- **[CONTRIBUTING.md](CONTRIBUTING.md)** - How to contribute
- **[manifest-schema.md](docs/manifest-schema.md)** - Technical reference for kits.yaml
## Architecture
**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
## Support & Contributing
- **Issues**: [GitHub Issues](https://github.com/tmorgan181/lite-kits/issues)
- **Discussions**: [GitHub Discussions](https://github.com/tmorgan181/lite-kits/discussions)
- **Contributing**: See [CONTRIBUTING.md](CONTRIBUTING.md)
## License
MIT License - see [LICENSE](LICENSE) for details.
## Acknowledgments
Built to enhance [GitHub Spec-Kit](https://github.com/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.
Raw data
{
"_id": null,
"home_page": null,
"name": "lite-kits",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ai, development-workflow, enhancement, git, kits, spec-kit",
"author": "lite-kits contributors",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/7b/aa/fb8a78bc0a0608f82335a7d67e498736abecb923ff280aeac69df258644b/lite_kits-0.3.3.tar.gz",
"platform": null,
"description": "# \ud83c\udf08 LITE-KITS \ud83c\udf92\n\n[](https://pypi.org/project/lite-kits/)\n[](https://www.python.org/downloads/)\n[](https://github.com/astral-sh/uv)\n[](https://github.com/github/spec-kit)\n[](https://opensource.org/licenses/MIT)\n\n**Lightweight enhancement kits for spec-driven development.**\n\n<img width=\"750\" height=\"450\" alt=\"lite-kits banner in terminal\" src=\"assets/banner.gif\" />\n\n## What is this?\n\n**lite-kits** adds productivity-enhancing slash commands to [spec-kit](https://github.com/github/spec-kit) projects. Get smart git workflows (`/commit`, `/pr`, `/cleanup`), project orientation (`/orient`), code quality tools (`/review`, `/audit`, `/stats`), and optional multi-agent coordination.\n\nIt's an **add-on**, not a fork\u2014your vanilla spec-kit stays vanilla, and you benefit from upstream updates automatically.\n\n## Quick Start\n\n### 1. Install lite-kits\n\n```bash\n# Recommended: Install with uv\nuv tool install lite-kits\n\n# Or with pip\npip install lite-kits\n```\n\n### 2. Add kits to your spec-kit project\n\n```bash\ncd your-spec-kit-project\n\n# Add dev-kit (all solo development commands)\nlite-kits add\n\n# Check what was installed\nlite-kits status\n```\n\n### 3. Use the commands\n\n```bash\n# In Claude Code or GitHub Copilot\n/orient # Get project context\n/commit # Smart commit with staging\n/pr # Create PR with auto-push\n/review # Review staged changes\n/cleanup # Clean up merged branches\n/audit # Security analysis\n/stats # Project metrics\n```\n\nThat's it! See [GUIDE.md](docs/GUIDE.md) for detailed command documentation and examples.\n\n## Features\n\n**Dev-Kit** (solo development):\n- `/orient` - Quick project orientation for AI agents\n- `/commit` - Smart commits with staging proposals and conventional commits\n- `/pr` - Pull request creation with auto-push and smart descriptions\n- `/review` - Code review against best practices\n- `/cleanup` - Safe merged branch cleanup\n- `/audit` - Security analysis on dependencies and code patterns\n- `/stats` - Project metrics and complexity analysis\n\n**Multiagent-Kit** (optional, for multi-agent workflows):\n- `/sync` - Multi-agent coordination status\n- Collaboration directories and templates\n- Memory guides (PR workflow, git worktrees protocol)\n\n**CLI Features:**\n- Beautiful terminal output with proper spacing\n- Preview-first (see changes before applying)\n- Smart auto-detection (agents and shells)\n- File count summaries\n- `help` command: `lite-kits help [COMMAND]`\n- `--force` flag to skip confirmations\n\n## Installation\n\n### Prerequisites\n\nlite-kits enhances GitHub spec-kit projects. You'll need:\n\n1. **Python 3.11+** - [Download here](https://www.python.org/downloads/)\n - Automatically checked by pip/uv during installation\n\n2. **Node.js & npm** - [Download here](https://nodejs.org/)\n - Required to install spec-kit (spec-kit is a Node.js package)\n\n3. **spec-kit** - GitHub's spec-driven development framework (REQUIRED)\n ```bash\n npm install -g @github/spec-kit\n ```\n - lite-kits won't work without spec-kit initialized first\n - Creates `.claude/` or `.github/prompts/` directories where commands are installed\n\n### Complete Installation Flow\n\n```bash\n# 1. Install spec-kit (if not already installed)\nnpm install -g @github/spec-kit\n\n# 2. Create a spec-kit project (or use existing)\nspecify init my-project\ncd my-project\n\n# 3. Install lite-kits\nuv tool install lite-kits # Recommended: with uv\n# OR\npip install lite-kits # Alternative: with pip\n\n# 4. Add enhancement kits to your project\nlite-kits add # Adds dev-kit (all commands)\n\n# 5. Start using commands in your AI assistant\n/orient # Get project context\n/commit # Smart commit workflow\n```\n\n### Alternative Install Methods\n\n**With pip:**\n```bash\npip install lite-kits\n```\n\n**From source:**\n```bash\ngit clone https://github.com/tmorgan181/lite-kits.git\ncd lite-kits\nuv build\nuv tool install dist/lite_kits-*.whl\n```\n\n### AI Assistant Compatibility\n\nlite-kits commands work with any AI assistant that supports slash commands:\n- \u2705 **GitHub Copilot** (VSCode extension or CLI) - Native GitHub integration\n- \u2705 **Claude Code** (VSCode extension)\n- \u2705 Any assistant that reads `.md` prompt files\n\nNo additional configuration required\u2014commands are just markdown files that your AI assistant reads.\n\n## CLI Commands\n\n```bash\n# Kit management\nlite-kits add # Add dev-kit\nlite-kits add --kit dev # Add specific kit\nlite-kits add --kit multiagent # Add multiagent-kit\nlite-kits remove --all # Remove all kits\nlite-kits remove --kit dev --force # Remove without confirmation\n\n# Status and info\nlite-kits status # Show installed kits\nlite-kits validate # Verify installation\nlite-kits info # Package information\nlite-kits help [COMMAND] # Show help\n\n# Global options\nlite-kits --version / -V # Show version\nlite-kits --banner # Show animated banner\nlite-kits --quiet / -q # Suppress output\nlite-kits --verbose / -v # Extra output\n```\n\nSee [GUIDE.md](docs/GUIDE.md) for detailed documentation and examples.\n\n## What's New in v0.2.0\n\n**Major rewrite with focus on modularity and UX:**\n\n- \u2728 Manifest-driven architecture (zero hardcoded logic)\n- \ud83d\udd27 Modular installer (detector, validator, conflict_checker)\n- \ud83d\udce6 Kit consolidation: project-kit + git-kit \u2192 **dev-kit**\n- \ud83c\udfa8 Perfect terminal spacing and file count summaries\n- \ud83d\udcac `help` command with optional command argument\n- \u26a1 `--force` flag for remove command\n- \ud83d\udc1b Fixed all critical bugs (#1, #3, #4, #6, #7)\n\nSee [CHANGELOG.md](CHANGELOG.md) for full release notes.\n\n## Documentation\n\n- **[GUIDE.md](docs/GUIDE.md)** - Complete command reference, workflows, and examples\n- **[CHANGELOG.md](CHANGELOG.md)** - Version history and migration notes\n- **[CONTRIBUTING.md](CONTRIBUTING.md)** - How to contribute\n- **[manifest-schema.md](docs/manifest-schema.md)** - Technical reference for kits.yaml\n\n## Architecture\n\n**Enhance, don't replace:**\n- lite-kits is an add-on for vanilla spec-kit (not a fork)\n- Only adds files, never modifies spec-kit core\n- Get upstream spec-kit updates automatically\n- Modular kits (add/remove as needed)\n\n**Content-first structure:**\n- `kits/{kit-name}/commands/{command}.{agent}.md`\n- Easy to add new commands, agents, and shells\n- Single manifest (kits.yaml) as source of truth\n\n**Modular installer:**\n- Auto-detect agents (Claude, Copilot) and shells (Bash, PowerShell)\n- Preview-first operations with conflict checking\n- Clean separation of concerns across focused modules\n\n## Support & Contributing\n\n- **Issues**: [GitHub Issues](https://github.com/tmorgan181/lite-kits/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/tmorgan181/lite-kits/discussions)\n- **Contributing**: See [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Acknowledgments\n\nBuilt to enhance [GitHub Spec-Kit](https://github.com/github/spec-kit), a framework for spec-driven development with AI agents.\n\n---\n\n**Status**: Beta (v0.3.0) - Ready for production use\n\n**Philosophy**: Enhance, don't replace. lite-kits adds features to vanilla spec-kit without forking or modifying core files.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Lightweight enhancement kits for vanilla dev tools (spec-kit, etc.)",
"version": "0.3.3",
"project_urls": {
"Documentation": "https://github.com/tmorgan181/lite-kits#readme",
"Homepage": "https://github.com/tmorgan181/lite-kits",
"Issues": "https://github.com/tmorgan181/lite-kits/issues",
"Repository": "https://github.com/tmorgan181/lite-kits"
},
"split_keywords": [
"ai",
" development-workflow",
" enhancement",
" git",
" kits",
" spec-kit"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "abebaa8389d337fa3f1ffebc9903c51aee4f5e3fb2247461c5bafbc99874cd24",
"md5": "1198118a84ee7f4d32cc747c4c48e323",
"sha256": "5feb627897f37b5b0e8a0832cd3cff3dfc8b3a05efda3446d2df0980f0cf2a79"
},
"downloads": -1,
"filename": "lite_kits-0.3.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1198118a84ee7f4d32cc747c4c48e323",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 107923,
"upload_time": "2025-10-12T17:47:44",
"upload_time_iso_8601": "2025-10-12T17:47:44.723953Z",
"url": "https://files.pythonhosted.org/packages/ab/eb/aa8389d337fa3f1ffebc9903c51aee4f5e3fb2247461c5bafbc99874cd24/lite_kits-0.3.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7baafb8a78bc0a0608f82335a7d67e498736abecb923ff280aeac69df258644b",
"md5": "9fd811b7056c8d2e24dca72e4566faa2",
"sha256": "1d2457299f9be62fd4b57b01fe783c9e926c444ba1d30406f3f5375fbbac35f0"
},
"downloads": -1,
"filename": "lite_kits-0.3.3.tar.gz",
"has_sig": false,
"md5_digest": "9fd811b7056c8d2e24dca72e4566faa2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 84768,
"upload_time": "2025-10-12T17:47:45",
"upload_time_iso_8601": "2025-10-12T17:47:45.879387Z",
"url": "https://files.pythonhosted.org/packages/7b/aa/fb8a78bc0a0608f82335a7d67e498736abecb923ff280aeac69df258644b/lite_kits-0.3.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-12 17:47:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tmorgan181",
"github_project": "lite-kits#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "lite-kits"
}
JSON
