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
| Service | Effect |
|---|---|
| Crispy: rephrase | Sends selected text to the configured CLI with a prompt to improve clarity while preserving meaning |
| Crispy: research | Sends selected text to the configured CLI with a prompt for concise, practical research context |
| Crispy: open in terminal | Opens a terminal session at the selected file or folder path |
Using a service
- Select text to rephrase or research, or select a file or folder to open in a terminal.
- Choose Right-click > Services.
- 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
--agentwhen 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_SECONDSenvironment 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.