§ CLI · MCP
CLI and MCP on Linux
The dettivo command reaches everything the app does and prints JSON with --json. One more command registers Dettivo as an MCP server in Claude Code, Codex, Cursor or Claude Desktop, with the nineteen tools of the Mac app to search transcripts, insert text or start a dictation, plus get_meeting_segments to follow a live meeting.
Who this is for
Developers wiring Dettivo into scripts, compositor bindings or coding agents. Skills written against Dettivo on the Mac use the same tool names here.
Connecting an agent
Terminal
bash
dettivo mcp config --host claude-code # prints the claude mcp add line
dettivo mcp config --host codex --write # merges into ~/.codex/config.toml
dettivo mcp config --host cursor --write # merges into ~/.cursor/mcp.json
dettivo mcp config --host claude-desktop --write # merges into the Claude Desktop config
dettivo mcp check # handshake with the daemon, tool count--write merges the entry into the host file and leaves every other server alone. Run it again after a change and the entry is replaced in place.
The command line
Terminal
bash
dettivo history search "release gate" --json
dettivo history latest
dettivo meetings list --json
dettivo meetings segments <id> --follow
dettivo dictation toggle
dettivo dictation stop --print
dettivo vocabulary import terms.txt
dettivo vocabulary suggest --apply
dettivo speech providers --language de
dettivo config set dictation.mode enhanced
dettivo doctorScripting it
--quiet prints nothing on success, which is what a compositor binding wants. Exit codes are fixed per error, so a script can tell an unreachable daemon from a missing model.
dettivo dictation stop --print finishes the take, prints the processed text on standard output and inserts nothing, so a script or a terminal agent reads a dictation with text=$(dettivo dictation stop --print). It waits up to 60 s for the transcription, and History records the take as printed.
dettivo events --follow streams dictation, meeting and download events as one JSON line each.
An optional REST shim listens on 127.0.0.1 behind a token. It is off by default.
dettivo completions bash, zsh or fish prints a completion script. The package installs all three.
Exit codes
| Exit | Meaning |
|---|---|
| 0 | Success. |
| 1 | Runtime failure. The error names the cause. |
| 2 | The daemon or its socket is unavailable. |
| 3 | Permission denied by the peer check or the token. |
| 4 | Invalid command or arguments. |
| 5 | Timeout or an interrupted operation. |
| 6 | No speech: dettivo dictation stop or stop --print on a take the speech gate found silent. |
Free and open source · GPL-3.0
Dettivo for Linux 0.5.0 is on GitHub.
The release page has the pacman package and its checksum. Bug reports go to the issue tracker. On a Mac? The native Mac app does all of this with Apple Silicon models.