> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruby.ad/llms.txt
> Use this file to discover all available pages before exploring further.

# Raycast Extension

Run any Ruby agent on text you've selected anywhere on your Mac. The agent's response replaces your selection in place, so you do not need to switch apps or copy and paste.

## Installation

Visit the Raycast Store extension page and click **Install Extension**.

## Setup

### Login to Ruby

Authenticate with your Ruby workspace credentials.

**Note:** If your workspace is in our EU region ([https://app.ruby.ad](https://app.ruby.ad)), update the Ruby URL in the Raycast extension settings.

### Pick a workspace

Select the Ruby workspace you want to use if you belong to several workspaces.

### Start talking to your agents

Open Raycast with `⌘ Space`, search for an agent, and start chatting.

## Bind an agent to a shortcut

The fastest way to use Ruby is to assign a keyboard shortcut to an agent, then trigger it on selected text in any app. This works for grammar fixes, translations, rewrites, and other tasks where you want the agent's response to replace the selected text.

1. Open **Raycast Settings → Extensions → Ruby**.
2. Click **Set up Replace Selection**.
3. Pick the agent you want to bind, such as a Grammar, Translate, Tone of Voice, Rewriter, or Support agent, then click **Create Quicklink**.
4. In the Quicklinks list, find the new entry and click **Record Hotkey**. Press the key combination you want, such as `⌘G`.
5. Repeat these steps for as many agents as you like. You can use a different shortcut for each agent, such as `⌘G` for Grammar and `⌘T` for Translate.

To use a shortcut, select text anywhere on your Mac and press the assigned key combination. The selected text is sent to the bound agent, and the agent's response replaces it in place. Raycast runs the command in the background and displays notifications for progress or errors instead of opening a window.

> [!NOTE]
>
> This works system-wide, not only inside Raycast or Ruby. You can select text in Apple Notes, a Slack message, a browser, an email draft, or any other app where text can be selected.

## General shortcuts

For quick access to a chat without replacing selected text, use Raycast's built-in **Aliases** and **Hotkeys** on any agent or on Ruby itself. For example, you can assign `⌥Q` to open a chat directly.

When you highlight content on a page and call Ruby in Raycast, the selected content is automatically sent as context to the agent. This is useful for editing an email draft or asking a question about a specific paragraph.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.