Text Services

CrispyVibe registers macOS system services for rephrasing or researching selected text from an app’s Services menu. A third service opens selected file or folder paths in a terminal.

Available services

ServiceEffect
Crispy: rephraseSends selected text to the configured CLI with a prompt to improve clarity while preserving meaning
Crispy: researchSends selected text to the configured CLI with a prompt for concise, practical research context
Crispy: open in terminalOpens a terminal session at the selected file or folder path

Using a service

  1. Select text to rephrase or research, or select a file or folder to open in a terminal.
  2. Choose Right-click > Services.
  3. Choose a service.

For rephrase or research, CrispyVibe replaces the selected text with the CLI response through the macOS pasteboard. For open in terminal, CrispyVibe opens a terminal session at the selected path.

Configuration

Open App Settings > AI Services to configure:

  • CLI profile — Kiro CLI, Claude Code, Codex, Gemini CLI, OpenCode, or custom
  • Command and arguments — the CLI command to invoke
  • Default agent — the agent identifier passed with --agent when agent-flag passing is enabled
  • Prompt templates — use {{text}} as the placeholder for selected text
  • Trust mode — Standard or Full Trust (passes --trust-all-tools)

Behavior details

  • Timeout: 20 seconds by default, configurable via the CRISPYVIBES_TEXT_SERVICE_TIMEOUT_SECONDS environment variable
  • Text over 4,000 characters is split into up to six labeled chunks sent in one prompt. Input beyond 24,000 characters is truncated.
  • CrispyVibe strips ANSI sequences from CLI output before writing the response to the pasteboard

⚠️ Note: Services require CrispyVibe to be running. If a service does not appear in the menu, restart CrispyVibe and check System Settings > Keyboard > Keyboard Shortcuts > Services.