Tiny bash shim that launches VivaDicta for Mac in CLI mode. Distributed via Homebrew so the install command stays short and stable:
brew install n0an/tap/vivadicta
vivadicta recent 5That's equivalent to:
/Applications/VivaDicta.app/Contents/MacOS/VivaDicta --cli recent 5The shim expects VivaDicta.app to live at /Applications/VivaDicta.app. Install the app from a DMG at https://vivadicta.com first; the shim itself has no other dependencies.
VivaDicta's CLI surfaces the same data the MCP server exposes, plus shell-friendly ergonomics (human-readable tables by default, JSON when piped, natural-language queries).
| Command | Purpose |
|---|---|
vivadicta recent [N] |
Last N transcriptions (default 10) |
vivadicta search <query> |
Full-text search with --since, --tag, --source, --mode, --limit filters |
vivadicta get <id-or-query> |
Fetch one by UUID or natural-language query; --output markdown for Obsidian |
vivadicta presets |
List AI rewrite presets (built-in + custom) |
vivadicta tags |
List user tags + source tags with counts |
vivadicta modes |
List Viva Modes (app-/URL-aware profiles) |
vivadicta vocab |
List custom vocabulary words |
vivadicta replacements |
List post-transcription find-and-replace rules |
vivadicta rewrite <id-or-query> --preset P |
Rewrite a transcription with an AI preset (writes; UI app must be running) |
vivadicta transcribe <file-or-url> [--async] |
Transcribe a local file or YouTube URL (writes; UI app must be running) |
vivadicta job <uuid> |
Poll an async job (writes) |
Global flags: --output {text,table,json,markdown}, --pretty, --quiet, --verbose, --help, --version.
TTY detection is automatic - vivadicta recent prints a table in your terminal and JSON when piped to another tool. Override with VIVADICTA_FORCE_TTY=1 / VIVADICTA_FORCE_NON_TTY=1.
For full per-subcommand flag reference, run vivadicta <subcommand> --help after install - the binary is the authoritative source.
If you want Claude Code / Cursor / Codex / etc. to invoke vivadicta for you with the right flags and flows, install the official skill pack:
npx skills add n0an/vivadicta-cli-skills --globalFour skills ship: a canonical-usage reference plus three workflow skills (transcribe, search-and-rewrite, vault-export). Source: n0an/vivadicta-cli-skills.
The main VivaDicta for Mac source lives in a private repo. Homebrew formulae need publicly-fetchable source URLs, so this tiny repo carries the shim and tags it for brew to pin against. The shim content is mirrored in the main repo's scripts/vivadicta for day-to-day development; this repo is the distribution canonical.
- n0an/vivadicta-mcp - the parallel shim for the MCP server (agent chat, not shell).
- n0an/vivadicta-cli-skills - agent skill pack.
- n0an/homebrew-tap - formula source for both shims.
MIT. See LICENSE.