{"id":27969613,"url":"https://github.com/clearclown/cursor-editor-in-linux","last_synced_at":"2026-05-05T23:31:42.827Z","repository":{"id":291891680,"uuid":"979127104","full_name":"clearclown/cursor-editor-in-Linux","owner":"clearclown","description":"Cursor Wayland Launcher - A wrapper script for Cursor editor that automatically enables Wayland support on Linux. Improves compatibility and performance for Wayland users.","archived":false,"fork":false,"pushed_at":"2025-05-07T03:59:44.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-07T21:49:33.540Z","etag":null,"topics":["appimage","bash","bash-script","cursor-ai","editor","linux","utility","vscode","wayland"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clearclown.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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}},"created_at":"2025-05-07T03:24:30.000Z","updated_at":"2025-05-07T03:59:48.000Z","dependencies_parsed_at":"2025-05-07T04:38:56.760Z","dependency_job_id":null,"html_url":"https://github.com/clearclown/cursor-editor-in-Linux","commit_stats":null,"previous_names":["clearclown/cursor-editor-in-linux"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clearclown%2Fcursor-editor-in-Linux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clearclown%2Fcursor-editor-in-Linux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clearclown%2Fcursor-editor-in-Linux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clearclown%2Fcursor-editor-in-Linux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clearclown","download_url":"https://codeload.github.com/clearclown/cursor-editor-in-Linux/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252961858,"owners_count":21832192,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["appimage","bash","bash-script","cursor-ai","editor","linux","utility","vscode","wayland"],"created_at":"2025-05-07T21:49:36.906Z","updated_at":"2026-05-05T23:31:42.789Z","avatar_url":"https://github.com/clearclown.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cursor Editor Linux Launcher\n\n## Translations\n\nThis project includes documentation in multiple languages:\n\n- [English (Default)](./README.md)\n- [日本語 / Japanese](./translation/Japa/README.ja.md)\n\nAdditional documentation in Japanese is available in the `translation/Japa/` directory:\n- [一般的な問題 / Common Issues](./translation/Japa/COMMON_ISSUES.ja.md)\n- [Cursorについて / About Cursor](./translation/Japa/ABOUT_CURSOR.ja.md)\n\nA robust launcher script for Cursor AI editor on Linux that enhances compatibility with Wayland and provides additional features for Linux users.\n\n\n## What is Cursor?\n\nCursor is an AI-powered code editor designed for pair programming with AI. It's a fork of Visual Studio Code with additional AI features like code generation, smart rewrites, and codebase queries. It allows developers to write code using natural language instructions and integrates advanced AI capabilities for enhanced productivity.\n\n## Features of This Launcher\n\n- **Wayland Optimization**: Automatically adds Wayland-specific flags for better compatibility\n- **AppImage Management**: Automatically finds and uses the latest Cursor AppImage\n- **Command Line Support**: Preserves all command line arguments you pass to the editor\n- **Metadata Access**: Shows version information with `-v` or `--version`\n- **Help System**: Displays help with `-h` or `--help`\n- **Debugging Tools**: Includes debugging support with `--verbose`\n- **Permissions Handling**: Automatically checks and sets executable permissions\n- **Path Handling**: Correctly handles file and directory paths\n\n## Installation\n\n1. Download the script:\n   ```bash\n   wget -O cursor https://raw.githubusercontent.com/clearclown/cursor-editor-in-Linux/main/cursor\n   ```\n\n2. Make it executable:\n   ```bash\n   chmod +x cursor\n   ```\n\n3. Move it to your system path:\n   ```bash\n   sudo mv cursor /usr/local/bin/\n   ```\n\n## Usage\n\nUse the script just like you would use Cursor normally:\n\n```bash\n# Open Cursor in the current directory\ncursor .\n\n# Open a specific file\ncursor /path/to/file.js\n\n# Open a specific folder\ncursor /path/to/project/\n\n# Get version information\ncursor -v\n\n# Get help\ncursor -h\n\n# Run with debug info\ncursor --verbose\n```\n\nThe script will automatically add the following flags for Wayland support:\n```\n--enable-features=UseOzonePlatform --ozone-platform=wayland --enable-wayland-ime\n```\n\n## Why Use This Launcher?\n\nCursor is available as an AppImage on Linux, which doesn't require traditional installation but can be tricky to set up properly. This launcher script addresses several common issues with running Cursor on Linux:\n\n1. **Wayland Support**: Improves compatibility with Wayland display server\n2. **Path Resolution**: Fixes issues with file and directory path handling\n3. **AppImage Management**: Eliminates the need to manually locate and execute the AppImage\n4. **Permissions**: Automatically handles executable permissions\n5. **Integration**: Provides proper system integration with version information and help\n\n## Configuration\n\nBy default, the script looks for Cursor AppImage in your `~/Downloads/` directory. If you store your AppImage elsewhere, edit the `CURSOR_DIR` variable in the script.\n\n## About Cursor's Features\n\nCursor offers several AI-powered features including:\n- Autocomplete and code prediction that adapts based on recent changes\n- Code generation that understands context\n- Multi-line edit suggestions\n\nAs it's a fork of Visual Studio Code, existing extensions and settings can be integrated into your workflow.\n\n## Requirements\n\n- Bash shell\n- `find` command\n- Cursor AppImage downloaded to your Downloads folder (or the directory specified in `CURSOR_DIR`)\n- For Wayland support: A Wayland compositor (like GNOME on Wayland, KDE Plasma Wayland, Sway, etc.)\n\n## Troubleshooting\n\nIf you encounter any issues:\n\n1. Run the script with `--verbose` to see debug information\n2. Make sure your Cursor AppImage has the correct filename format (`cursor-*x86_64.AppImage`)\n3. Verify that the AppImage is in the expected directory\n4. Ensure the AppImage has execute permissions\n5. If you see SUID sandbox errors, you may need to adjust permissions on the chrome-sandbox file\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclearclown%2Fcursor-editor-in-linux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclearclown%2Fcursor-editor-in-linux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclearclown%2Fcursor-editor-in-linux/lists"}