Extension Icon

Respace

Open apps, files, folders, URLs, and terminal commands in organized workspace bundles
Overview
Respace Logo

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

  1. Clone this repository
  2. Install dependencies: npm install
  3. Build the extension: npm run build
  4. Import into Raycast

๐ŸŽฎ Usage

๐Ÿ†• Creating a Workspace

  1. Open "Manage Workspaces" command
  2. Press Cmd+N to create a new workspace
  3. 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"
  4. Set optional launch delays for each item
  5. Save your workspace

โ–ถ๏ธ Launching a Workspace

  1. Open "Open Workspace" command
  2. Search for your workspace
  3. Press Enter to launch all items

๐ŸŽฏ Quick Opening Individual Items

  1. Open "Quick Open" command
  2. Type to search across all workspace items
  3. 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.