Mira CLI command reference
Reference verified Mira CLI commands for setup, session listing and export, full-text search, files, MCP configuration, AI jobs, backup, and service mode.
Core Commands
Use these commands to initialize your environment, check system health, and run full-text searches across all your transcripts and notes.
Terminal
$ mira init
# Initialize Mira's local state and wiki.
$ mira doctor
# Check state, wiki, and index health.
$ mira search "your query"
# Search transcript text and indexed wiki content.
$ mira version
# Print CLI version.
Session Management
Manage your captured meeting records. You can list sessions, read transcripts, export data, or edit segments directly from the CLI.
View and Export
Terminal
$ mira session list --limit 10
# List recent sessions. Filter by date, source, state, pinned/starred.
$ mira session show <session-id>
# Show one session and its transcript.
$ mira session export <session-id> --format md
# Export transcript (supported formats: md, txt, srt, json).
Create and Edit
Terminal
$ mira session create --text "Meeting context" --title "Client Sync"
# Manually create a session (or load from file using --from).
$ mira session edit <session-id> --from file.md
# Overwrite a session's finalized transcript body.
$ mira session pin <session-id>
# Toggle a session's pinned state.
Maintenance
Terminal
$ mira session prune --max-age-days 30
# Delete sessions older than N days (keeps pinned/starred).
$ mira session delete <session-id>
# Permanently delete a session record.
Local Wiki
Manage wiki pages within your Local Wiki, handle backlinks, and view index structures.
Read and Write
Terminal
$ mira wiki list
# List all wiki pages.
$ mira wiki show <path>
# Show a wiki page by path (e.g. topics/pcb-design).
$ mira wiki write <path> --from doc.md
# Create or overwrite a wiki page by path.
Links and Maintenance
Terminal
$ mira wiki backlinks <path>
# List pages that reference a specific wiki page.
$ mira wiki sessions <path>
# List session IDs linked to a wiki page.
$ mira wiki delete <path>
# Delete a wiki page by path and update indexes.
$ mira wiki rebuild-index
# Drop and rebuild the wiki file/link index from scratch.
Admin & Config
Configure AI providers, manage MCP settings, view active configuration, and run system maintenance tools.
AI and MCP Integration
Terminal
$ mira config show
# View your current Mira configuration.
$ mira mcp configure <client-id>
# Automatically inject Mira MCP into an AI editor (e.g. cursor, vscode).
$ mira mcp list
# List AI clients that currently have the Mira MCP server installed.
$ mira ai run <template-name> --session <id>
# Execute a prompt template against a session using your configured AI.
$ mira ai provider probe <provider-id>
# List available models from your configured AI provider.
Server and Backup
Terminal
$ mira admin export-backup ~/Desktop/mira-backup.zip --app-version <version> --app-build <build>
# Export sessions, segments, and speakers to JSONL backup.
$ mira serve
# Run the Mira MCP server manually (alias for `mcp serve`).