```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

```

• 📜 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

`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 # Interactive mode (prompts for target)

cursor-kit remove --target cursor # Remove from Cursor IDE

cursor-kit remove --target github-copilot # Remove from GitHub Copilot

cursor-kit remove --target google-antigravity # Remove from Google AntiGravity

cursor-kit remove -t command -n my-command # Quick remove

cursor-kit remove -f # Skip confirmation

cursor-kit remove --target cursor -t rule -n my-rule -f # Full example

```

`share`

Share AI IDE configs over LAN or Internet via HTTP. Perfect for transferring your configuration to another machine.

```bash

cursor-kit share # Interactive mode (choose LAN or Internet)

cursor-kit share -p 9000 # Use a specific port

cursor-kit share -n lan # Share over local network only

cursor-kit share -n internet # Share via public tunnel URL

cursor-kit share -n internet -t localtunnel # Use localtunnel (default, free)

cursor-kit share -n internet -t ngrok # Use ngrok (more reliable)

```

Network modes:

| Mode | Description | Use Case |

|------|-------------|----------|

| lan | Local network only | Same WiFi/network, faster |

| internet | Public tunnel URL | Different networks, anywhere |

Tunnel providers:

| Provider | Pros | Setup |

|----------|------|-------|

| localtunnel | Free, no account required | Works out of the box |

| ngrok | More reliable, stable URLs | Requires [free account](https://dashboard.ngrok.com) |

How it works:

• Detects available configs (.cursor, .agent, .github) in current directory
• Starts an HTTP server (LAN) or creates a public tunnel (Internet)
• Displays the receive command to run on the target machine
• Automatically shuts down after successful transfer

`receive`

Receive and extract shared AI IDE configs from a cursor-kit share URL.

```bash

cursor-kit receive http://192.168.1.15:8080 # Receive from LAN URL

cursor-kit receive https://abc123.loca.lt # Receive from tunnel URL

cursor-kit receive https://abc123.ngrok.io # Receive from ngrok URL

cursor-kit receive -f # Force overwrite without prompts

```

Conflict handling:

When existing configs are detected, you can choose to:

• Overwrite - Replace all conflicting files
• Merge - Keep existing files, add new ones only
• Cancel - Abort the operation

Example workflow (LAN):

```bash

# On source machine (has the configs)

cd ~/project-with-configs

cursor-kit share -n lan

# Output: cursor-kit receive http://192.168.1.15:8080

# On target machine (same network)

cd ~/new-project

cursor-kit receive http://192.168.1.15:8080

```

Example workflow (Internet):

```bash

# On source machine (has the configs)

cd ~/project-with-configs

cursor-kit share -n internet

# Output: cursor-kit receive https://abc123.loca.lt

# On target machine (anywhere in the world)

cd ~/new-project

cursor-kit receive https://abc123.loca.lt

```

`instance`

Manage multiple Cur