Cursor Kicker

AI Development Framework for Next.js projects with intelligent Cursor rules, memory banks, and MCP-powered workflows.

What is Cursor Kicker?

Cursor Kicker automatically configures your Next.js projects with:

• Intelligent Cursor Rules - Best practices for Next.js, TypeScript, and quality standards
• Memory Bank System - Project context that keeps AI informed about your codebase
• MCP-Powered Commands - Workflows that leverage GitHub and Vercel integrations
• Project Scaffolding - Start new projects with everything configured

Key Features

🎯 Next.js Focused

Deep integration with Next.js App Router, Server Components, and modern patterns.

🔗 GitHub MCP Integration

• Auto-sync issues to backlog
• Track work with issue linking
• Automated PR creation
• Branch management

🚀 Vercel MCP Integration

• Monitor deployments
• Debug build failures
• Check deployment status
• Access preview URLs

🧠 Memory Bank

Keep AI context fresh with:

• Project brief and goals
• Technical stack info
• Active work context
• Progress tracking
• Backlog from GitHub issues
• Deployment status

⚡ Smart Commands

• @kickoff - Quick task starter
• @start-sprint - Feature development workflow
• @wrapup - Complete work with auto-updates
• @sync-backlog - Sync GitHub issues
• @check-deployment - Monitor Vercel
• @create-task - Create GitHub issues
• @debug-build - Debug failed builds

Installation

npm install -g cursor-kicker

Quick Start

Initialize Existing Project

cd your-nextjs-project
cursor-kicker init

Start from Empty Folder

You can also run cursor-kicker init in an empty folder:

mkdir my-project
cd my-project
cursor-kicker init

Automatic Next.js Creation: If no Next.js project is detected, Cursor Kicker will automatically offer to create one using create-next-app in interactive mode. You'll be prompted to choose your configuration options (TypeScript, ESLint, Tailwind, etc.).

If the folder is not empty, you'll be asked to confirm before creating the Next.js project.

Alternative: Create Next.js First

You can also create your Next.js project manually first:

npx create-next-app@latest my-project
cd my-project
cursor-kicker init

The CLI will:

1. Detect your Next.js configuration (or create it automatically)
2. Extract GitHub repository information (if connected)
3. Detect Vercel deployment settings (if deployed)
4. Generate Cursor rules and commands
5. Set up the memory bank system

Usage

Once initialized, your project will have:

your-project/
├── .cursor/
│   ├── rules/              # AI coding rules
│   │   ├── 00-core-standards.mdc
│   │   ├── 01-quality-gates.mdc
│   │   ├── 02-nextjs-patterns.mdc
│   │   ├── 03-github-workflows.mdc
│   │   └── 04-vercel-workflows.mdc
│   └── commands/           # AI workflow commands
│       ├── kickoff.md
│       ├── start-sprint.md
│       ├── wrapup.md
│       └── ...
└── memory-bank/            # Project context
    ├── project-brief.md
    ├── technical-context.md
    ├── backlog.md
    └── ...

Using Commands

In Cursor, simply mention commands in your prompts:

@start-sprint - Let's build the user authentication feature

The AI will:

1. Check your GitHub issues
2. Review memory bank context
3. Create a comprehensive plan
4. Track progress in the issue

Requirements

• Node.js 18+
• Next.js project (or create new)
• GitHub repository
• Vercel project (optional but recommended)
• Cursor IDE with MCP configured

Documentation

• Getting Started
• Quick Reference
• Project Summary
• Changelog

Project Philosophy

Project-Scoped Configuration: Everything is contained within your project and committed to git. No global dependencies, making projects portable and team-ready.

MCP-First Design: Workflows designed around GitHub issue tracking and Vercel deployments for seamless automation.

Next.js Best Practices: Rules encode the latest Next.js patterns, App Router conventions, and performance optimizations.

License

MIT

Links

• Repository: https://github.com/a-und-b/cursor-kicker
• Issues: https://github.com/a-und-b/cursor-kicker/issues
• Changelog: CHANGELOG.md

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.