Skip to main content

Execution Workflows

Rephlo offers multiple ways to trigger commands, allowing you to choose the one that best fits your current task.

1. The Global Hotkey (Keyboard)

Fastest for text already selected.

  1. Select text in any application.
  2. Press the Context Menu Hotkey:
    • macOS: Shift+Cmd+C (⇧⌘C)
    • Windows & Linux: Ctrl+Shift+Alt+C
  3. Type to search for a command (e.g., "Sum..") and hit Enter.
    • Result: The output streams in a progress dialog and is copied to your clipboard.

Tip: The hotkey can be customized in Settings > Hotkeys.

┌─────────────────────────────────────────────────────────────────────────┐
│ EXECUTION WORKFLOW: HOTKEY │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ STEP 1 STEP 2 STEP 3 │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │ │
│ │ │ Browser │ │ [======] │ │ macOS: ⇧⌘C │ │ │
│ │ │ │ ───▶ │ Selected │ ───▶ │ Win: │ │ │
│ │ │ [text..] │ │ Text │ │ Ctrl+Shift+Alt+C │ │ │
│ │ └──────────┘ └──────────┘ └────────┬─────────┘ │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ STEP 4 STEP 5 STEP 6 │ │
│ │ │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │ │
│ │ │ Command │ │ Streaming │ │ Result copied │ │ │
│ │ │ Overlay │ │ Progress │ │ to clipboard │ │ │
│ │ │ ┌──────────┐ │ │ Dialog │ │ │ │ │
│ │ │ │Search... │ │───▶│ ┌────────┐ │───▶│ Paste with │ │ │
│ │ │ │>Summarize│ │ │ │ 2.3s │ │ │ Ctrl+V / ⌘V │ │ │
│ │ │ │ Fix... │ │ │ │[====>] │ │ │ anywhere │ │ │
│ │ │ └──────────┘ │ │ └────────┘ │ └──────────────────┘ │ │
│ │ └──────────────┘ │ [Cancel] │ │ │
│ │ └──────────────┘ │ │
│ │ │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘

Fastest overall -- the overlay opens as you finish selecting text.

Instead of selecting text and then pressing a hotkey, you can trigger the command overlay during the text selection itself. Hold a modifier key while drag-selecting text, and the overlay appears the moment you release the mouse.

How It Works

  1. Hold the modifier key (default: Cmd on macOS, Ctrl on Windows/Linux).
  2. Drag your mouse to select text in any application while still holding the modifier.
  3. Release the mouse button -- the command overlay appears instantly with the selected text pre-loaded.
  4. Pick a command from the overlay, or type to search.

Tip: Configure which modifier key to use in Settings > Hotkeys > Text Selection Trigger.

┌─────────────────────────────────────────────────────────────────────────┐
│ EXECUTION WORKFLOW: DRAG-SELECT TRIGGER │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ STEP 1 STEP 2 │ │
│ │ Hold modifier + drag Release mouse │ │
│ │ │ │
│ │ ┌────────────────────┐ ┌────────────────────┐ │ │
│ │ │ Any Application │ │ Any Application │ │ │
│ │ │ │ │ │ │ │
│ │ │ Hold ⌘ (macOS) │ │ [======Selected=] │ │ │
│ │ │ or Ctrl (Win) │ ───▶ │ │ │ │
│ │ │ then drag-select │ │ Mouse released! │ │ │
│ │ │ [====selecting===] │ │ │ │ │
│ │ └────────────────────┘ └─────────┬──────────┘ │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ STEP 3 STEP 4 │ │
│ │ Overlay appears Execute command │ │
│ │ │ │
│ │ ┌────────────────────┐ ┌────────────────────┐ │ │
│ │ │ Command Overlay │ │ Streaming Progress │ │ │
│ │ │ ─────────────── │ │ ┌────────┐ │ │ │
│ │ │ Search... │ ───▶ │ │ 1.8s │ │ │ │
│ │ │ > Fix Grammar │ │ │[====>] │ │ │ │
│ │ │ Summarize │ │ └────────┘ │ │ │
│ │ │ Translate │ │ │ │ │
│ │ └────────────────────┘ │ Result --> clipboard │ │
│ │ └────────────────────┘ │ │
│ │ │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘

Configuring the Modifier Key

Open Settings > Hotkeys and find the Text Selection Trigger section. Choose one of:

ModifiermacOSWindows/Linux
DefaultCmdCtrl
AlternativeOptionAlt
AlternativeShiftShift

Pick a modifier you do not frequently use for other text selection operations to avoid unintended triggers.

When to Use Drag-Select vs. Global Hotkey

ScenarioRecommended Trigger
Selecting text and immediately processing itDrag-Select (one fluid motion)
Text is already selected (e.g., double-click word)Global Hotkey (no re-selection needed)
Working with keyboard-heavy selection (Shift+arrows)Global Hotkey
Processing text in rapid successionDrag-Select (fastest loop)

Note: After your first successful command execution, Rephlo displays a Command Success Guide dialog that introduces the drag-select workflow and helps you configure it.

3. The System Tray (Mouse)

Good for mouse-heavy workflows.

  1. Select text.
  2. Click the Rephlo icon in the System Tray.
  3. The Command Runner opens with your text pre-loaded.
  4. Click a command.

4. Drag and Drop

Good for processing files.

  1. Drag a text file or PDF from your desktop.
  2. Drop it onto the Rephlo Tray Icon or Dashboard.
  3. Rephlo will ask if you want to:
    • Add to Space: Import it.
    • Process: Run a command on its content immediately.

5. Screenshot / Vision Commands

For images, diagrams, and UI analysis.

  1. Trigger the Screenshot feature:
    • macOS: Shift+Cmd+S (⇧⌘S)
    • Windows & Linux: Ctrl+Shift+Alt+S
  2. Draw a rectangle around the area of interest.
  3. Rephlo captures the image.
  4. Select a Vision Command (e.g., "Describe Image", "Extract Text").
  5. Rephlo analyzes the image and returns the text result in the Screenshot Analysis Result dialog.

Tip: The screen capture hotkey can be customized in Settings > Hotkeys.

┌─────────────────────────────────────────────────────────────────────────┐
│ SCREENSHOT CAPTURE WORKFLOW │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ STEP 1 STEP 2 │ │
│ │ macOS: ⇧⌘S Draw selection box │ │
│ │ Win: Ctrl+Shift+Alt+S │ │
│ │ │ │
│ │ ┌────────────────────┐ ┌────────────────────┐ │ │
│ │ │ [Desktop Screen] │ │ ┌──────────────┐ │ │ │
│ │ │ │ ──▶ │ │ + + + + + + │ │ │ │
│ │ │ Error dialog │ │ │ + Capture +│ │ │ │
│ │ │ visible here │ │ │ + Area +│ │ │ │
│ │ │ │ │ │ + + + + + + │ │ │ │
│ │ └────────────────────┘ │ └──────────────┘ │ │ │
│ │ └────────────────────┘ │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ STEP 3 STEP 4 │ │
│ │ Select Vision Command AI Analyzes Image │ │
│ │ │ │
│ │ ┌────────────────────┐ ┌────────────────────┐ │ │
│ │ │ Vision Commands │ │ SCREENSHOT ANALYSIS│ │ │
│ │ │ ─────────────── │ │ RESULT │ │ │
│ │ │ > Extract Text │ ──▶ │ "Error 0x8004005: │ │ │
│ │ │ Describe Image │ │ Unspecified error │ │ │
│ │ │ Debug UI │ │ in module..." │ │ │
│ │ │ Explain Diagram │ │ │ │ │
│ │ └────────────────────┘ │ (Auto-copied) │ │ │
│ │ └────────────────────┘ │ │
│ │ │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘

6. Result Handling

Once a command finishes:

  • Automatic Clipboard Copy: The result is automatically copied to your clipboard on completion.
  • Paste Anywhere: Use Ctrl+V (Windows/Linux) or Cmd+V (macOS) in any application to insert the result.
  • Streaming Preview: Watch the AI response stream in real-time in the progress dialog.
  • Cancel Anytime: Click Cancel in the progress dialog to stop a long-running operation.

Note: Results are also logged in the History view for future reference.


Next Feature: History & Audit Trail.