# Shell Click for Raycast

URL: https://www.raycast.com/Envl/shell-click

> Companion extension for Shell Click (https://shellclick.dev): search and run saved commands, switch workspaces, and manage listening ports. Requires the Shell Click macOS app.

- Install: raycast://extensions/Envl/shell-click
- Author: [GnimOay](https://www.raycast.com/Envl)
- Installs: 0
- Platforms: macOS
- Categories: Developer Tools, Productivity
- Updated: 2026-11-18
- Source: https://github.com/raycast/extensions/tree/7bcdce103499b2ab011f389760eb60beb95bc5d7/extensions/shell-click/

## Commands

- **Search Command**: Search and run saved commands, or manage listening ports

## README

### Shell Click for Raycast

The companion extension for [Shell Click](https://shellclick.dev), a macOS app for saving and running project commands. Search and control your Shell Click commands, workspaces, and listening ports directly from Raycast.

**Requires Shell Click 0.1.25 or later, installed separately.** [Download Shell Click](https://shellclick.dev).

#### Setup

1. Download Shell Click from [shellclick.dev](https://shellclick.dev), move **ShellClick.app** to Applications, and launch it.
2. Add your commands and their working folders in Shell Click. Create workspaces there to organize them.
3. Open **Search Command** in Raycast.

The extension finds your installed app automatically. If you keep it elsewhere, set **Shell Click App Path** in the extension preferences to the absolute path of `ShellClick.app`. Reopen Search Command after changing this preference.

#### Features

- Search by command name, command text, folder path, or detected port.
- Filter all commands, running commands, listening ports, or a Shell Click workspace.
- Open a command’s terminal or editor in Shell Click; start, stop, restart, or delete saved commands.
- Copy working-folder paths or open folders in another app.
- Open listening ports in your default browser with Return, or stop their processes after confirmation.
- Open Shell Click’s Commands and Settings tabs.

Workspaces come from Shell Click; they are not generated automatically from folder paths. The extension uses the same saved commands and sessions as the app.

#### Keyboard Shortcuts

| Shortcut | Action |
| --- | --- |
| Return | Open the selected command’s terminal or port |
| ⌘ K | Show actions for the selected row |
| ⌘ Return | Start or stop the selected command |
| ⌘ R | Refresh |
| Escape | Go back |

Lists refresh when opened, when filters change, after actions, or with **⌘ R**.

#### Troubleshooting

If the extension cannot find Shell Click, install the latest app and check **Shell Click App Path**. The app must include its bundled command helper. If opening a terminal or editor fails, launch Shell Click once, then retry.

The extension communicates locally with Shell Click’s bundled helper. It does not upload your commands or create separate copies of your commands and workspaces. Stop sends SIGTERM. Force Kill sends SIGKILL; process actions require confirmation.
