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), 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.- Open Raycast Settings → Extensions → Ruby.
- Click Set up Replace Selection.
- Pick the agent you want to bind, such as a Grammar, Translate, Tone of Voice, Rewriter, or Support agent, then click Create Quicklink.
- In the Quicklinks list, find the new entry and click Record Hotkey. Press the key combination you want, such as
⌘G. - Repeat these steps for as many agents as you like. You can use a different shortcut for each agent, such as
⌘Gfor Grammar and⌘Tfor Translate.
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.