Install globally

<p align="center">
  <img src="./thumbnail.png" alt="Cursor Kit" width="768" />
</p>

<h1 align="center">✦ Cursor Kit ✦</h1>

<p align="center">
  <b>Supercharge your AI IDE with rules & commands</b><br/>
  <sub>A CLI toolkit to manage, share, and sync Cursor IDE, GitHub Copilot, and Google AntiGravity configurations</sub>
</p>

<p align="center">
  <a style="text-decoration: none;" href="https://www.npmjs.com/package/cursor-kit-cli" target="_blank">
    <img src="https://img.shields.io/npm/v/cursor-kit-cli?style=flat-square&color=000000" alt="npm version" />
  </a>
  <a style="text-decoration: none;" href="https://www.npmjs.com/package/cursor-kit-cli" target="_blank">
    <img src="https://img.shields.io/npm/dm/cursor-kit-cli?style=flat-square&color=000000" alt="npm downloads" />
  </a>
  <!-- <img src="https://img.shields.io/github/license/duongductrong/cursor-kit?style=flat-square&color=0047E1" alt="license" /> -->
</p>

## 🚀 Quick Start

```bash
# Install globally
npm install -g cursor-kit-cli

# Or use directly with npx
npx cursor-kit-cli init
```

**CLI Aliases:** `cursor-kit`, `cursorkit`, or `ck`

```bash
# All of these work
cursor-kit init
cursorkit init
ck init
```

## ✨ Features

- **📜 Commands** - Reusable prompt templates for common tasks
- **📋 Rules** - Project-specific AI behavior guidelines
- **🎓 Skills** - Comprehensive guides with references for specialized domains
- **🔄 Sync** - Keep configurations updated from the community
- **🎯 Multi-Target** - Support for Cursor IDE, GitHub Copilot, and Google AntiGravity
- **🔗 Share Anywhere** - Share configs over LAN or Internet (via localtunnel/ngrok)
- **🖥️ Multi-Instance** - Run multiple Cursor accounts simultaneously (macOS)
- **⚡ Instance Aliases** - Create shell commands to quickly open projects in specific instances
- **🎨 Beautiful CLI** - Delightful terminal experience

## 📦 Commands

### `init`

Initialize commands, rules, and skills in your project with curated templates. Supports Cursor IDE, GitHub Copilot, and Google AntiGravity.

```bash
cursor-kit init                       # Interactive: choose target IDE
cursor-kit init -t cursor             # Initialize for Cursor IDE (.cursor/)
cursor-kit init -t github-copilot     # Initialize for GitHub Copilot (.github/copilot-instructions/)
cursor-kit init -t google-antigravity # Initialize for Google AntiGravity (.agent/)
cursor-kit init -c                    # Only initialize commands
cursor-kit init -r                    # Only initialize rules
cursor-kit init -s                    # Only initialize skills
cursor-kit init -f                    # Force overwrite existing files
cursor-kit init -a                    # Install all templates without selection prompts
```

**Target options:**
- `cursor` (default) - Creates `.cursor/` directory structure for Cursor IDE
- `github-copilot` - Creates `.github/copilot-instructions.md` and related structure for GitHub Copilot
- `google-antigravity` - Creates `.agent/` directory with rules, workflows, and skills for Google AntiGravity

### `add`

Interactively create a new command, rule, or skill with a starter template. Supports targeting different AI IDEs.

```bash
cursor-kit add                              # Interactive mode (prompts for target)
cursor-kit add --target cursor              # Add to Cursor IDE
cursor-kit add --target github-copilot      # Add to GitHub Copilot
cursor-kit add --target google-antigravity  # Add to Google AntiGravity
cursor-kit add -t command                   # Add a command
cursor-kit add -t rule                      # Add a rule
cursor-kit add -t skill                     # Add a skill
cursor-kit add -t command -n my-command     # Quick create
cursor-kit add --target cursor -t rule -n my-rule  # Full example
```

### `pull`

Fetch the latest updates from the cursor-kit repository. Supports targeting different AI IDEs.

```bash
cursor-kit pull                         # Interactive mode (prompts for target)
cursor-kit pull -t cursor               # Pull to Cursor IDE
cursor-kit pull -t github-copilot       # Pull to GitHub Copilot
cursor-kit pull -t google-antigravity   # Pull to Google AntiGravity
cursor-kit pull -c                      # Only pull commands
cursor-kit pull -r                      # Only pull rules
cursor-kit pull -s                      # Only pull skills
cursor-kit pull -f                      # Force overwrite without confirmation
cursor-kit pull -t cursor -r -f         # Pull rules to Cursor with force
```

### `list`

Display all available commands, rules, and skills in your project.

```bash
cursor-kit list           # List everything
cursor-kit list -c        # Only list commands
cursor-kit list -r        # Only list rules
cursor-kit list -s        # Only list skills
cursor-kit list -v        # Verbose mode with file paths
```

### `remove`

Remove a command, rule, or skill from your project. Supports targeting different AI IDEs.

```bash
cursor-kit remove                        # Intera

... (truncated)