{"id":26607053,"url":"https://github.com/fisapool/cursor-workspace-configurator","last_synced_at":"2026-05-18T03:02:20.317Z","repository":{"id":282594405,"uuid":"949083724","full_name":"fisapool/cursor-workspace-configurator","owner":"fisapool","description":"Interactive web tool for configuring Cursor IDE workspaces with customized AI rules, project settings, and export options for consistent development environments.","archived":false,"fork":false,"pushed_at":"2025-03-15T18:20:29.000Z","size":43,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-20T07:39:04.519Z","etag":null,"topics":["cursor","dev-environment","javasscript","productivity","terminal"],"latest_commit_sha":null,"homepage":"https://fisapool.github.io/cursor-workspace-configurator/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fisapool.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-15T16:31:55.000Z","updated_at":"2025-10-15T21:46:38.000Z","dependencies_parsed_at":"2025-10-12T22:42:08.126Z","dependency_job_id":"7a53ea3d-5f65-4bff-8b23-30b205b588a7","html_url":"https://github.com/fisapool/cursor-workspace-configurator","commit_stats":null,"previous_names":["fisapool/cursor-workspace-configurator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fisapool/cursor-workspace-configurator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fcursor-workspace-configurator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fcursor-workspace-configurator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fcursor-workspace-configurator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fcursor-workspace-configurator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fisapool","download_url":"https://codeload.github.com/fisapool/cursor-workspace-configurator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fisapool%2Fcursor-workspace-configurator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33163413,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"online","status_checked_at":"2026-05-18T02:00:06.436Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cursor","dev-environment","javasscript","productivity","terminal"],"created_at":"2025-03-23T22:36:21.877Z","updated_at":"2026-05-18T03:02:20.297Z","avatar_url":"https://github.com/fisapool.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cursor Workspace Configurator\n\nA tool for setting up and configuring [Cursor IDE](https://cursor.sh/) workspaces with optimal settings for your projects. Configure once, deploy anywhere, and keep your AI-powered development environment consistent across all your workspaces.\n\n## Features\n\n### Ready Features ✅\n\n- ✅ **Web Interface**: Interactive configurator with a clean, terminal-like experience\n- ✅ **Customizable Project Configuration**: Set up your workspace exactly how you need it\n- ✅ **Project Type Templates**: Web, Mobile, Backend, Desktop, Library/Package\n- ✅ **AI Rules Configuration**: Optimize Cursor's AI for your specific use case\n- ✅ **Workspace Export Options**:\n  - ✅ Export directly to Cursor with automated installation scripts\n  - ✅ Download a `.code-workspace` file for immediate use with Cursor\n- ✅ **Cross-Platform Automation**:\n  - ✅ OS-specific installation scripts (macOS, Windows, Linux)\n  - ✅ Auto-detection of Cursor installation paths\n  - ✅ Automatic backup of existing settings\n\n### Coming Soon 🚧\n\n- 🚧 **Command-line Tool**: For direct integration into your workflow\n- 🚧 **Executable Distributions**:\n  - 🚧 Standalone desktop application (Windows, macOS, Linux)\n  - 🚧 Offline usage capability\n  - 🚧 System tray integration for quick access\n- 🚧 **Enterprise Features**:\n  - 🚧 Team configuration sharing\n  - 🚧 Version control integration\n  - 🚧 Configuration profiles for different project types\n\n## Desktop Application 🚧\n\n\u003e 🚧 **IN DEVELOPMENT** - The desktop application is currently under development and will be available soon.\n\nFor those who prefer a native experience, the Cursor Workspace Configurator will be available as a downloadable executable:\n\n### Windows (Coming Soon)\n```bash\n# Download the installer (link will be available when released)\ncurl -LO https://github.com/yourusername/cursor-workspace-configurator/releases/latest/download/CursorWorkspaceConfigurator-Setup-Windows.exe\n\n# Or use the portable version\ncurl -LO https://github.com/yourusername/cursor-workspace-configurator/releases/latest/download/CursorWorkspaceConfigurator-Portable-Windows.exe\n```\n\n### macOS (Coming Soon)\n```bash\n# Download the .dmg file (link will be available when released)\ncurl -LO https://github.com/yourusername/cursor-workspace-configurator/releases/latest/download/CursorWorkspaceConfigurator-macOS.dmg\n\n# Or install with Homebrew\nbrew install cursor-workspace-configurator\n```\n\n### Linux (Coming Soon)\n```bash\n# Download the AppImage (link will be available when released)\ncurl -LO https://github.com/yourusername/cursor-workspace-configurator/releases/latest/download/CursorWorkspaceConfigurator-Linux.AppImage\nchmod +x CursorWorkspaceConfigurator-Linux.AppImage\n\n# Or install with Snap\nsnap install cursor-workspace-configurator\n```\n\n## Web Interface\n\nVisit the [Cursor Workspace Configurator Web App](https://fisapool.github.io/cursor-workspace-configurator/) to use the interactive web interface.\n\n### Quick Start with Web Interface\n\n1. Visit the web app\n2. Choose setup mode (Quick Setup or Custom Setup)\n3. Enter your project description and details\n4. When configuration is complete, choose from the export options:\n   - Export to Cursor: Get instructions and scripts to apply settings to your Cursor installation\n   - Workspace File Only: Download just the `.code-workspace` file for direct import\n\n## Command Line Usage 🚧\n\n\u003e 🚧 **IN DEVELOPMENT** - The command line tool is currently under development and will be available soon.\n\nThe Cursor Workspace Configurator will be usable directly from the command line for efficiency and automation:\n\n```bash\n# Install globally (not yet available)\nnpm install -g cursor-workspace-configurator\n\n# Or run without installing (not yet available)\nnpx cursor-workspace-configurator\n\n# In your project directory (not yet available)\ncursor-workspace-setup\n\n# With arguments for non-interactive usage (coming soon)\ncursor-workspace-setup --type web --languages \"javascript,typescript\" --frameworks \"react,next.js\" --rules \"custom-rules.txt\" --output \"./my-workspace\"\n\n# Generate configuration from existing projects (coming soon)\ncursor-workspace-setup --from-project \"/path/to/existing/project\"\n\n# Apply a saved profile (coming soon)\ncursor-workspace-setup --profile \"web-development\"\n```\n\n### Planned CLI Options 🚧\n\n```\nUsage: cursor-workspace-setup [options]\n\nOptions:\n  -t, --type \u003ctype\u003e              Project type: web, mobile, backend, desktop, library\n  -l, --languages \u003clanguages\u003e     Comma-separated list of programming languages\n  -f, --frameworks \u003cframeworks\u003e   Comma-separated list of frameworks\n  -d, --description \u003cdescription\u003e Project description\n  -r, --rules \u003cfile\u003e              Path to AI rules file\n  -o, --output \u003cdirectory\u003e        Output directory for configuration files\n  -p, --profile \u003cname\u003e            Use a saved configuration profile\n  --from-project \u003cdirectory\u003e      Generate config based on existing project\n  --early-access                  Enable Early Access Program features\n  --beta                          Enable Beta features\n  --debug                         Enable verbose debug output\n  --export-only                   Generate files without applying them\n  -h, --help                      Display help information\n  -v, --version                   Display version information\n```\n\n## Automation Scripts ✅\n\nThe Cursor Workspace Configurator provides platform-specific automation scripts to streamline the installation process:\n\n### macOS Script ✅\n\nThe macOS automation script:\n- ✅ Creates the Cursor user directory if it doesn't exist (`~/Library/Application Support/Cursor/User/`)\n- ✅ Backs up any existing configuration files\n- ✅ Installs the new `settings.json` with your configuration\n- ✅ Creates a `.cursorrules` file in your home directory\n- ✅ Provides color-coded feedback for each step\n\n### Windows Script ✅\n\nThe Windows automation script:\n- ✅ Locates the Cursor application data folder (`%APPDATA%\\Cursor\\User\\`)\n- ✅ Creates backup copies of existing configuration\n- ✅ Installs the new settings and rules files\n- ✅ Handles Windows-specific path requirements\n- ✅ Includes detailed error reporting and success confirmation\n\n### Linux Script ✅\n\nThe Linux automation script:\n- ✅ Targets the standard Linux configuration path (`~/.config/Cursor/User/`)\n- ✅ Creates necessary directories with proper permissions\n- ✅ Installs configuration files with appropriate ownership\n- ✅ Provides detailed execution logs\n- ✅ Returns proper exit codes for integration with other tools\n\n### Security Considerations\n\nThe automation scripts:\n- ✅ Run entirely on the local machine (no remote execution)\n- ✅ Do not collect or transmit any data\n- ✅ Are provided as plaintext scripts you can review before running\n- ✅ Require appropriate permissions to modify configuration files\n\nTo run the scripts:\n\n```bash\n# On macOS/Linux\nchmod +x install-cursor-config.sh\n./install-cursor-config.sh\n\n# On Windows (PowerShell)\n.\\install-cursor-config.ps1\n# Or Windows (Command Prompt)\ninstall-cursor-config.bat\n```\n\n## Opening Your Workspace in Cursor\n\n### Using the Workspace File (.code-workspace)\n\n1. Open Cursor\n2. Go to \"File\" → \"Open Workspace...\"\n3. Select your downloaded `.code-workspace` file\n4. Start coding with your optimized settings!\n\n### Using Export to Cursor\n\n1. Click \"Export to Cursor\" after configuration is complete\n2. Choose one of the installation methods:\n   - Follow the manual instructions to copy settings to your Cursor user directory\n   - Download and run the automation script for your OS (macOS, Windows, or Linux)\n3. Restart Cursor to apply the changes\n\n## Configuration Options\n\n- **Project Description**: A description of your project\n- **Project Type**: Web Application, Mobile App, Backend Service, Desktop Application, Library/Package\n- **Languages and Frameworks**: Configure based on your tech stack\n- **Editor Settings**: Tab size, spaces/tabs, format on save\n- **AI Rules**: Custom rules for Cursor's AI behavior\n- **Early Access Features**: Enable cutting-edge Cursor features\n- **Beta Settings**: Try experimental capabilities\n\n## Debug Mode\n\nDebug Mode provides additional information and troubleshooting capabilities:\n\n- Toggle with the Debug Mode button in the top-right corner\n- Adds a debug panel showing current configuration state\n- Outputs detailed logs to the browser console\n- Adds debug messages directly to the terminal\n- Provides a debug log download option when configuration is complete\n- Includes a \"Dump Config to Console\" button for quick inspection\n\n## Workspace Structure\n\nThe configurator creates the following configuration for Cursor:\n\n```\nsettings.json        # Main settings for Cursor\n.cursorrules         # AI behavior rules for the entire workspace\n```\n\n## Advanced Settings Customization\n\nAfter opening your workspace, you can further customize settings:\n\n1. Go to \"Preferences\" → \"Settings\"\n2. Search for specific settings to modify\n\n## Local Development\n\nTo run the web interface locally:\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/cursor-workspace-configurator.git\n\n# Navigate to the project directory\ncd cursor-workspace-configurator\n\n# Start a local server (Python example)\npython -m http.server 8081\n\n# Open in browser\n# Visit http://localhost:8081\n```\n\n## Building Executables 🚧\n\n\u003e 🚧 **IN DEVELOPMENT** - The build process is currently under development and will be available soon.\n\nYou will be able to build standalone executables of the Cursor Workspace Configurator for distribution:\n\n### Prerequisites\n\n- Node.js 14+ and npm installed\n- Electron for desktop builds\n- Appropriate build tools for your platform\n\n### Build Process (Coming Soon)\n\n```bash\n# Install dependencies\nnpm install\n\n# Build for all platforms\nnpm run build:all  # Coming soon\n\n# Build for specific platforms\nnpm run build:win  # Coming soon\nnpm run build:mac  # Coming soon\nnpm run build:linux  # Coming soon\n\n# Output will be in the 'dist' directory\n```\n\n### Customizing for Your Team (Coming Soon)\n\nOrganizations will be able to customize the configurator for their specific needs:\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/cursor-workspace-configurator.git\n\n# Create a custom configuration file (template will be available soon)\ncp config.example.json config.custom.json\n\n# Edit the configuration file\n# - Add company-specific templates\n# - Set default AI rules\n# - Configure preferred settings\n\n# Build with custom configuration (coming soon)\nnpm run build:custom -- --config=config.custom.json\n```\n\n### Integration Options (Planned)\n\n- 🚧 **CI/CD Pipeline**: Include the configurator in your onboarding process\n- 🚧 **Internal Developer Portal**: Host a customized version for your team\n- 🚧 **Version Control**: Store configuration profiles in your repository\n- 🚧 **IDE Extensions**: Build a direct integration with Cursor for seamless updates\n\n### Custom Rule Sets (Planned)\n\nCreate organization-specific rule sets to enforce coding standards:\n\n```javascript\n// Example custom rules file (template): company-rules.js\nmodule.exports = {\n  naming: {\n    enforceConsistentNaming: true,\n    namePatterns: {\n      components: '^[A-Z][a-zA-Z]+$',\n      hooks: '^use[A-Z][a-zA-Z]+$'\n    }\n  },\n  formatting: {\n    tabSize: 2,\n    insertSpaces: true\n  },\n  aiRules: [\n    'Follow company code style guide',\n    'Use TypeScript for all new components',\n    'Document public APIs with JSDoc',\n    'Write unit tests for critical functions'\n  ]\n};\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffisapool%2Fcursor-workspace-configurator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffisapool%2Fcursor-workspace-configurator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffisapool%2Fcursor-workspace-configurator/lists"}