Respace - Workspace Manager for Raycast
A powerful Raycast extension to open apps, files, folders, URLs, and terminal commands in organized workspace bundles with a single click.
โจ Features
- ๐ฆ Workspace Bundles: Group apps, folders, files, URLs, and terminal commands together
- ๐ One-Click Launch: Open entire workspaces instantly
- โก Quick Open: CLI-style launcher for instant access to workspace items
- โฑ๏ธ Launch Delays: Configure delays between opening items
- ๐ Quick Search: Find workspaces quickly with Raycast's search
- โ๏ธ Full CRUD: Create, edit, and delete workspaces easily
- ๐พ Local Storage: Data stored in
~/.config/respace-raycast/
- ๐จ Beautiful UI: Native Raycast UI with icons and error handling
- ๐ Deeplinks: Share direct links to your workspaces
๐งญ Commands
๐๏ธ Open Workspace
List and launch your workspaces. Simply search for a workspace and press Enter to open all its items.
โก Quick Open
CLI-style quick launcher for instant access to any item across all your workspaces. Type to search and press Enter to open individual items without launching the entire workspace.
๐ ๏ธ Manage Workspaces
Create, edit, and delete workspaces with a full management interface.
๐ฆ Installation
- Clone this repository
- Install dependencies:
npm install
- Build the extension:
npm run build
- Import into Raycast
๐ฎ Usage
๐ Creating a Workspace
- Open "Manage Workspaces" command
- Press
Cmd+N to create a new workspace
- Add items:
- Apps: e.g., "Google Chrome", "Slack"
- Folders: e.g., "/Users/username/Projects"
- Files: e.g., "/Users/username/Documents/notes.md"
- URLs: e.g., "https://github.com"
- Terminal: e.g., "cd ~/project && npm start"
- Set optional launch delays for each item
- Save your workspace
โถ๏ธ Launching a Workspace
- Open "Open Workspace" command
- Search for your workspace
- Press Enter to launch all items
๐ฏ Quick Opening Individual Items
- Open "Quick Open" command
- Type to search across all workspace items
- Press Enter to open just that item (without launching the entire workspace)
๐งช Example Workspace
Web Development Environment
- VS Code (app)
- Chrome (app)
- GitHub (URL) - 1s delay
- Project folder (folder) - 2s delay
- Terminal:
cd ~/project && npm start - 3s delay
๐งโ๐ป Development
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Lint code
npm run lint
# Fix lint issues
npm run fix-lint
๐งฐ Technology Stack
- TypeScript: Type-safe development
- Raycast API: Native Raycast integration
- Prettier: Code formatter
- ESLint: Code linter
๐พ Storage
Workspaces are stored as JSON in ~/.config/respace-raycast/workspaces.json
๐ License
MIT
๐ค Contributing
Contributions are welcome! Please open an issue or submit a pull request.