GSD for Cursor IDE

Get Shit Done — A meta-prompting, context engineering, and spec-driven development system adapted for Cursor IDE.

Overview

This is the Cursor IDE adaptation of the Get Shit Done (GSD) system, originally built for Claude Code. GSD provides a structured workflow for solo developers using AI tools to build software reliably.

What GSD Provides

• 27 slash commands for project lifecycle management
• 11 specialized agents for different tasks (planning, execution, verification, research)
• Workflow documents with detailed process logic
• Templates for generated artifacts
• Reference documents for deep guidance

Screenshots

Prerequisites

• Cursor IDE version 2.4 or later

Quick Start

Installation

# Windows (PowerShell)
.\scripts\install.ps1

# macOS/Linux
./scripts/install.sh

Basic Workflow

/gsd-map-codebase     # Map existing codebase — when needed
/gsd-new-project      # Initialize project with questioning → research → requirements → roadmap
/gsd-discuss-phase 1  # Capture implementation decisions
/gsd-plan-phase 1     # Create executable plans
/gsd-execute-phase 1  # Execute plans with atomic commits
/gsd-verify-work 1    # User acceptance testing

Documentation

Document	Description
GSD-CURSOR-ADAPTATION.md	Complete technical adaptation guide
MIGRATION.md	How to update from GSD master
CHANGELOG.md	Version history

Directory Structure

gsd-for-cursor/
├── README.md                    # This file
├── MIGRATION.md                 # Migration guide for updates
├── CHANGELOG.md                 # Version history
├── docs/
│   └── GSD-CURSOR-ADAPTATION.md # Complete adaptation reference
├── scripts/
│   ├── install.ps1              # Windows installer
│   ├── install.sh               # macOS/Linux installer
│   ├── migrate.ps1              # Windows migration script
│   └── migrate.sh               # macOS/Linux migration script
└── src/
    ├── commands/                # Slash commands (flat gsd-*.md files)
    ├── agents/                  # Adapted agent definitions
    ├── bin/                     # CLI tools (gsd-tools.cjs + lib/)
    ├── workflows/               # Workflow documents
    ├── templates/               # Output templates
    ├── references/              # Deep guidance documents
    └── hooks/                   # Session hooks

Key Differences from Claude Code GSD

Aspect	Claude Code	Cursor
Command prefix	/gsd:command	/gsd-command
Config directory	~/.claude/	~/.cursor/
Tool names	PascalCase (Read)	snake_case (read)
Tools frontmatter	allowed-tools: [Read, Write]	tools: { read: true, write: true }
Colors	Names (yellow)	Hex (#FFFF00)

Devcontainer Support

GSD installs to ~/.cursor/ on the host. To make it available inside devcontainers without modifying shared project config, use the dotfiles repository approach -- a standard mechanism that Cursor/VS Code provides for personal tooling.

Setup (one-time)

1. Create a personal dotfiles repo (e.g., your-github-id/dotfiles) with an install.sh that clones and installs GSD:

#!/bin/bash
# install.sh in your dotfiles repo
GSD_REPO="https://github.com/user/gsd-for-cursor.git"
GSD_DIR="/tmp/gsd-for-cursor"

if command -v node &> /dev/null; then
    git clone --depth 1 "$GSD_REPO" "$GSD_DIR" 2>/dev/null
    if [ -d "$GSD_DIR" ]; then
        bash "$GSD_DIR/scripts/install.sh" --force
        rm -rf "$GSD_DIR"
    fi
fi

2. Add these settings to your personal Cursor settings (not the project):

{
    "dotfiles.repository": "your-github-id/dotfiles",
    "dotfiles.installCommand": "install.sh",
    "dotfiles.targetPath": "~/dotfiles"
}

Every new devcontainer will now auto-install GSD without affecting teammates who don't use Cursor or GSD.

Migration from GSD Master

To update this adaptation when the upstream GSD repository is updated:

# Windows
.\scripts\migrate.ps1 -SourcePath "path/to/gsd-master"

# macOS/Linux
./scripts/migrate.sh --source "path/to/gsd-master"

See MIGRATION.md for detailed instructions.

Contributing

1. Fork this repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

License

MIT License - see LICENSE for details.

Credits

• Original GSD system: glittercowboy/get-shit-done
• Cursor migration adaptation created by Royi Mindel