Dictare / Docs / CLI Reference

CLI Reference¶

dictare agent¶

Launch an AI coding agent with voice input.

dictare agent <name> [options]

Option	Description
`--profile`	Agent profile override
`--verbose`	Enable debug output
`--no-status-bar`	Hide the terminal status bar
`--continue`	Resume previous agent session
`--live-dangerously`	Skip agent permission prompts (YOLO mode)

dictare agent ozzy
dictare agent ozzy --continue
dictare agent gilmour --profile codex --verbose

dictare service¶

Manage the Dictare background service.

dictare service <action>

Action	Description
`install`	Install the system service
`uninstall`	Remove the system service
`start`	Start the service
`stop`	Stop the service
`restart`	Restart the service
`status`	Show service status
`logs`	View service logs

dictare service start
dictare service status
dictare service logs

dictare speak¶

Text-to-speech output.

dictare speak "Hello, world" [options]

Option	Description
`--list-engines`	List available TTS engines
`--list-voices`	List voices for the current engine
`--language`	Language code
`--engine`	TTS engine override for this request
`--voice`	Speaker name

dictare speak "Build complete"
dictare speak "Test passed" --engine kokoro
dictare speak --list-engines
dictare speak --list-voices

dictare transcribe¶

dictare transcribe [options]

Option	Description
`--auto-submit`	Automatically submit on silence
`--url`	Server URL
`--agent-id`	Custom agent ID

dictare transcribe                # Transcription to stdout
dictare transcribe --auto-submit  # Print each transcription immediately

The Unix Pipe Dream¶

This one's for you, Simon.

dictare transcribe | llm | dictare speak

Speak into the mic. Your words flow through llm, and the answer comes back as speech. Voice in, voice out — three commands, zero code.

dictare status¶

Show engine health and connected agents.

dictare status [options]

Option	Description
`--json`	Output as JSON

dictare status
dictare status --json

dictare logs¶

View Dictare logs.

dictare logs [options]

Option	Description
`--follow`, `-f`	Follow log output (like `tail -f`)
`--last`	Show last N lines
`--name`	Filter by logger name
`--source`	Filter by source
`--raw`	Show raw log format
`--tts`	Show TTS-specific logs

dictare logs -f
dictare logs --last 50
dictare logs --name pipeline

dictare models¶

Manage STT and TTS models.

dictare models [action]

Lists available models, downloads new ones, or deletes cached models.

dictare models              # List available models
dictare models download     # Download a model
dictare models delete       # Delete a cached model

dictare config¶

Open the configuration file in your default editor.

dictare config

dictare version¶

Show version and dependency information.

dictare version [options]

Option	Description
`--deps`	Show dependency versions

dictare version
dictare version --deps

dictare setup¶

Run the initial setup wizard. Guides you through audio device selection, STT model download, and hotkey configuration.

dictare setup

dictare tray¶

Manage the system tray icon.

dictare tray start      # Start tray icon
dictare tray stop       # Stop tray icon
dictare tray status     # Show tray status

The tray icon shows engine status, lets you toggle listening, switch agents, and access settings. It is installed automatically with dictare service install.