Dettivo

§ CLI · MCP

CLI and MCP on Linux

Developer toolLocal-only

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 nineteen tools to search transcripts, insert text or start a dictation.

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 dictation toggle
dettivo config set dictation.mode enhanced
dettivo doctor

Scripting 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 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.

§ Related

Free and open source · GPL-3.0

Dettivo for Linux 0.2.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.