Cursor CLI

{
  "llms": {
    "cursor": {
      "enabled": true,
      "workingDirectory": "."
    }
  }
}

{
  "llms": {
    "cursor": {
      "enabled": true,
      "workingDirectory": ".",
      "model": "claude-3.5-sonnet",  // Model via your Cursor subscription
      "timeout": 60000,
      "context": {
        "includeOpenFiles": true,
        "maxFiles": 10
      }
    }
  }
}

forge task create \
  --title "Create user profile card" \
  --description "
  Build a user profile card component with:
  - Avatar image
  - Name and bio
  - Social links
  - Follow button

  Make it responsive and accessible.
  " \
  --llm cursor

# Initial version
forge task create "Add dark mode toggle" --llm cursor

# Quick iteration
forge task fork 1 --llm cursor \
  --description "Make it smoother with animation"

# Another iteration
forge task fork 1 --llm cursor \
  --description "Add system preference detection"

forge task create \
  --title "Add new API endpoint" \
  --description "Create /api/users endpoint following existing patterns" \
  --llm cursor

# Better with Claude
forge task create \
  --title "Implement optimal pathfinding algorithm" \
  --llm claude  # Not cursor

Cursor Pro ($20/month):
├── 500 fast premium requests
├── Unlimited slow requests
├── Claude 3.5 Sonnet access
├── GPT-4 access
└── Priority support

Forge integration = No additional cost!

forge task create \
  --title "Build product listing page" \
  --description "
  Grid layout with:
  - Product cards (image, title, price)
  - Filters (category, price range)
  - Sorting options
  - Pagination
  - Mobile responsive
  " \
  --llm cursor

forge task create \
  --title "Create reusable modal component" \
  --description "
  Modal with:
  - Backdrop click to close
  - ESC key to close
  - Focus trap
  - Accessible (ARIA)
  - Smooth animations
  " \
  --llm cursor

forge task create \
  --title "Improve button hover states" \
  --description "
  Add smooth transitions and better visual feedback
  to all buttons in src/components/
  " \
  --llm cursor

# Basic usage
forge task create "Add navigation bar" --llm cursor

# With specific instructions
forge task create \
  --title "Refactor forms to use React Hook Form" \
  --llm cursor \
  --files "src/forms/**/*.tsx"

# With design reference
forge task create \
  --title "Implement this design" \
  --attach mockup.png \
  --llm cursor

# Step 1: Claude designs the API
forge task create \
  --title "Design GraphQL schema" \
  --llm claude

# Step 2: Cursor builds the UI
forge task create \
  --title "Build GraphQL query components" \
  --llm cursor

# Login via browser
cursor auth login

# Verify authentication
cursor auth status

# Output:
# ✓ Logged in as user@example.com
# ✓ Pro subscription active
# ✓ 450/500 fast requests remaining

# Check remaining requests
cursor quota

# Output:
# Fast requests: 450/500
# Resets: Jan 20, 2024

# Logout
cursor auth logout

# Login again
cursor auth login

forge task create \
  --title "Build analytics dashboard" \
  --description "
  Create dashboard with:
  - 4 stat cards (users, revenue, sessions, conversion)
  - Line chart for trends
  - Table with recent activity
  - Responsive grid layout
  - Dark mode support

  Use Tailwind CSS and Recharts
  " \
  --llm cursor

forge task create \
  --title "Create user profile edit form" \
  --description "
  Form with:
  - Input fields: name, email, bio, avatar upload
  - Validation (email format, required fields)
  - Loading state during submission
  - Success/error messages
  - Accessible form controls
  " \
  --llm cursor

# Good ✅
forge task create \
  --title "Add pricing cards" \
  --description "
  3 pricing tiers (Basic, Pro, Enterprise)
  - Vertical cards on mobile
  - Horizontal comparison on desktop
  - Highlight 'Pro' tier
  - Include feature lists
  - Use brand colors: #FF00FF, #00FFFF
  " \
  --llm cursor

# Bad ❌
forge task create \
  --title "pricing page" \
  --llm cursor

forge task create \
  --title "Add product modal" \
  --description "
  Similar to existing CartModal in src/components/CartModal.tsx
  but for product details instead of cart
  " \
  --llm cursor

forge task create \
  --title "Add animation to hero section" \
  --description "
  Use Framer Motion for:
  - Fade in on mount
  - Stagger child elements
  - Smooth scroll parallax
  " \
  --llm cursor