integrations

Glimpse CLI integrations

The glimpse command exposes Glimpse to external tools: Raycast extensions, macOS Shortcuts, Finder Quick Actions, and shell scripts. Read commands work with no app running; commands that change state or transcribe talk to the running app (launching it if needed).

Install the CLI from Glimpse → Settings → General → Install command line tool (creates ~/.local/bin/glimpse).

Output and exit codes

Add --json to any command for machine-readable output ({"ok":true,…}; errors go to stderr as {"ok":false,"error":…}).

Exit	Meaning
0	Success
1	User error (bad args, file/item not found)
2	App required but not running / failed to launch
3	Job failed
4	Cancelled or --wait timed out

Recipe mapping

Action	Command
Finder → Transcribe to text	glimpse transcribe "$@"
Finder → Transcribe to Library	glimpse library import "$@" --open
Shortcut → Copy last dictation	glimpse history last
Shortcut → Add dictionary word	glimpse dictionary add "$1"
Raycast → Search history	glimpse history search "$1" --limit 20 --json
Raycast → Switch model	glimpse model set "$1"
Open Glimpse history	glimpse open history

Command reference

Run glimpse <command> --help for full options.

• glimpse history last | list | search | get | stats
• glimpse dictionary list | add | remove
• glimpse replacements list | add | remove
• glimpse model list | set
• glimpse library import | status | list | export
• glimpse transcribe <file>… [--output|--output-dir|--stdout|--json|--model|--language|--cleanup]
• glimpse open [history|models] [--tab …]
• glimpse status
• glimpse api status | start | stop