Content
<div align="center">
<img src="docs/assets/banner.png" alt="Cursor Kit for AI" width="600">
# Cursor Kit for AI
**Not an IDE. A library of production-ready solutions for Cursor-powered development.**
[](https://github.com/kiurakku/cursor-kit-for-ai/actions/workflows/ci.yml)
[](LICENSE)
[](https://www.python.org/downloads/)
[](docs/catalog.md)
[](plugins/README.md)
[](CONTRIBUTING.md)
[Quick Start](#quick-start) · [Templates](#template-catalog) · [Plugins](#plugins) · [CLI](#cli-reference) · [Docs](docs/catalog.md)
<br>
```bash
pip install -e .
cursorkit create full-stack-saas my-app
cd my-app && cp .env.example .env && docker compose up -d --build
```
**~20 seconds later:** React · FastAPI · PostgreSQL · Redis · Docker · GitHub Actions · SSL · Monitoring
</div>
---
## What is this?
Cursor Kit for AI is a **scaffolding library** for developers who use [Cursor](https://cursor.com) as a force multiplier. One CLI command gives you a complete, production-ready project — not a tutorial, not a snippet, a **real stack you can ship**.
| You want | Run |
|----------|-----|
| Full SaaS product | `cursorkit create full-stack-saas my-app` |
| Telegram bot | `cursorkit create telegram-bot alerts` |
| MCP server for Cursor | `cursorkit create mcp-servers my-tools` |
| Cursor skills / workflows | `cursorkit plugin install engineering` |
**22 templates** · **6 plugins** · **20+ skills** · **MIT license**
---
## Plugins
Cursor Kit includes **6 plugins** by **Cloud9's** — Cursor Agent skills for engineering, DevOps, data, automation, security, and productivity.
```bash
cursorkit plugin list
cursorkit plugin install engineering # code-review, deploy-checklist, incident-response
cursorkit plugin install devops --global # docker-audit, k8s-review, ci-fix
cursorkit plugin install --all # install everything
```
| Plugin | Skills | Pair With |
|--------|--------|-----------|
| `engineering` | code-review, deploy-checklist, incident-response, standup | `full-stack-saas`, `ci-cd` |
| `devops` | docker-audit, k8s-review, ci-fix, monitoring-check | `docker`, `kubernetes`, `monitoring` |
| `data` | sql-write, pipeline-review, dashboard-build | `postgresql` |
| `automation` | bot-scaffold, scraper-review, workflow-design | `telegram-bot`, `scraper`, `n8n` |
| `security` | secrets-audit, waf-review, harden-vps | `cloudflare`, `vps-setup`, `anti-bot` |
| `productivity` | daily-plan, task-triage, session-context | any project |
Skills install to `.cursor/skills/` and activate automatically in Cursor Agent.
Full guide: **[plugins/README.md](plugins/README.md)** · **[docs/plugins.md](docs/plugins.md)**
---
**22 templates** · **246+ files per full stack** · **Zero vendor lock-in**
---
## Table of Contents
- [Quick Start](#quick-start)
- [CLI Reference](#cli-reference)
- [Template Catalog](#template-catalog)
- [Plugins](#plugins)
- [Full-Stack SaaS](#full-stack-saas)
- [Using with Cursor](#using-with-cursor)
- [Architecture](#architecture)
- [Testing](#testing)
---
## Quick Start
### Prerequisites
| Tool | Version |
|------|---------|
| Python | 3.10+ |
| Docker + Compose | v2+ |
| Git | 2.30+ |
### Install
```bash
git clone https://github.com/kiurakku/cursor-kit-for-ai.git
cd cursor-kit-for-ai
python -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
```
### Create & Run
```bash
cursorkit list
cursorkit info full-stack-saas
cursorkit create full-stack-saas my-saas --domain app.example.com --author "Your Name"
cd my-saas
cp .env.example .env # change SECRET_KEY and POSTGRES_PASSWORD
docker compose up -d --build
```
| Service | URL |
|---------|-----|
| App | http://localhost:3000 |
| API Docs | http://localhost:8000/docs |
| Grafana | http://localhost:3001 |
---
## CLI Reference
```bash
cursorkit --version
cursorkit list [--tag docker]
cursorkit info <template>
cursorkit create <template> <name> [options]
```
| Option | Description |
|--------|-------------|
| `-o, --output` | Output directory |
| `--domain` | Production domain |
| `--author` | Project author name |
| `--force` | Overwrite existing dir |
| `--dry-run` | Preview without writing |
---
## Template Catalog
<details>
<summary><b>Core Infrastructure</b> (5 templates)</summary>
| ID | Stack | Description |
|----|-------|-------------|
| [`full-stack-saas`](templates/full-stack-saas) | React, FastAPI, Postgres, Redis | Complete SaaS with auth, CI/CD, monitoring |
| [`docker`](templates/docker) | Node, Python, Nginx | Multi-stage Docker patterns |
| [`kubernetes`](templates/kubernetes) | K8s, Ingress, HPA | Production manifests |
| [`vps-setup`](templates/vps-setup) | Ubuntu, Caddy, systemd | Server hardening + deploy |
| [`ci-cd`](templates/ci-cd) | GitHub Actions | Test, build, deploy, rollback |
</details>
<details>
<summary><b>Databases & Caching</b> (2 templates)</summary>
| ID | Description |
|----|-------------|
| [`postgresql`](templates/postgresql) | Postgres 16, Alembic, backup scripts |
| [`redis`](templates/redis) | Rate limiting, cache, pub/sub |
</details>
<details>
<summary><b>Auth & Payments</b> (3 templates)</summary>
| ID | Description |
|----|-------------|
| [`auth`](templates/auth) | JWT + refresh tokens + RBAC |
| [`stripe`](templates/stripe) | Subscriptions, checkout, webhooks |
| [`telegram-login`](templates/telegram-login) | Telegram Login Widget |
</details>
<details>
<summary><b>Bots & Automation</b> (3 templates)</summary>
| ID | Description |
|----|-------------|
| [`telegram-bot`](templates/telegram-bot) | aiogram 3, webhook + polling |
| [`discord-bot`](templates/discord-bot) | discord.py slash commands |
| [`n8n`](templates/n8n) | Self-hosted n8n + PostgreSQL |
</details>
<details>
<summary><b>Data Collection</b> (3 templates)</summary>
| ID | Description |
|----|-------------|
| [`scraper`](templates/scraper) | Playwright + proxy rotation |
| [`parser`](templates/parser) | HTML/JSON pipeline |
| [`proxy-rotation`](templates/proxy-rotation) | Proxy pool manager |
</details>
<details>
<summary><b>Security & Edge</b> (2 templates)</summary>
| ID | Description |
|----|-------------|
| [`cloudflare`](templates/cloudflare) | Workers + WAF rules |
| [`anti-bot`](templates/anti-bot) | Fingerprinting + rate limits |
</details>
<details>
<summary><b>Web3 & AI</b> (4 templates)</summary>
| ID | Description |
|----|-------------|
| [`web3-wallet`](templates/web3-wallet) | ethers.js wallet connect |
| [`mcp-servers`](templates/mcp-servers) | MCP server for Cursor |
| [`ai-agents`](templates/ai-agents) | LangGraph agent + tools |
| [`monitoring`](templates/monitoring) | Prometheus + Grafana + Loki |
</details>
Full details: **[docs/catalog.md](docs/catalog.md)**
---
## Full-Stack SaaS
The flagship template — everything for a real product:
```
my-saas/
├── frontend/ React 18 + Vite + TypeScript + Tailwind
├── backend/ FastAPI + SQLAlchemy + JWT auth
├── deploy/ Caddy SSL + zero-downtime deploy.sh
├── monitoring/ Prometheus + Grafana
├── docker-compose.yml 6 services, healthchecks
└── .github/workflows/ CI → build → deploy
```
---
## Using with Cursor
```
1. cursorkit create full-stack-saas my-app # scaffold
2. Open in Cursor # @README.md for context
3. Extend with Agent # predictable structure
4. git push # CI deploys automatically
```
For MCP: `cursorkit create mcp-servers my-tools` — includes `.cursor/mcp.json`.
---
## Architecture
```
Caddy (TLS) → Frontend (React) + Backend (FastAPI) → PostgreSQL + Redis
↓
Prometheus → Grafana
```
See [docs/architecture.md](docs/architecture.md).
---
## Testing
```bash
pip install -e ".[dev]"
pytest -v
ruff check cursorkit tests
cursorkit create full-stack-saas test -o /tmp/test --force
```
---
## License
MIT — by **Cloud9's**. Use freely in commercial and personal projects. PRs welcome — see [CONTRIBUTING.md](CONTRIBUTING.md).
---
<div align="center">
**Stop building infrastructure. Start building products.**
`cursorkit create full-stack-saas my-app`
</div>
Connection Info
You Might Also Like
No recommendations available