@hypothesi/tauri-mcp-cli
v0.10.0
Published
CLI wrapper for calling the Tauri MCP server tools directly from the terminal
Maintainers
Readme
@hypothesi/tauri-mcp-cli
CLI wrapper for calling the Tauri MCP server tools directly from the terminal.
Install
npm install -g @hypothesi/tauri-mcp-cliOr run without a permanent install:
npx @hypothesi/tauri-mcp-cli <command>Session Lifecycle
Most automation tools require an active driver session. Start one before calling other tools.
1. Start a session
tauri-mcp driver-session start --port 9223The session connects to a Tauri app running in development mode (cargo tauri dev) on the specified port. The MCP server process stays alive in the background via MCPorter keep-alive, so later commands reuse the same session.
2. Call tools in separate invocations
tauri-mcp webview-screenshot --file screenshot.png
tauri-mcp webview-execute-script --script "document.title"
tauri-mcp driver-session status --jsonEach command exits normally. Session state persists across invocations.
3. Stop the session
tauri-mcp driver-session stopOutput
- Image-producing tools write image files to disk by default.
- Default filename:
<tool-name>-<timestamp>.pngin the current directory. - Use
--file <path>to control the output filename. - Use
--jsonto print structured JSON output. Images are still written to disk; the JSON includes their file paths.
Daemon Management
The keep-alive daemon persists the MCP server between commands. Manage it directly:
tauri-mcp daemon status # Show daemon status
tauri-mcp daemon stop # Stop the daemon
tauri-mcp daemon start # Start or prewarm the daemon
tauri-mcp daemon restart # Restart the daemonTroubleshooting
"No active session" error
The daemon restarted and lost session state. Re-run driver-session start:
tauri-mcp driver-session start --port 9223Connection refused or stale daemon
tauri-mcp daemon restart
tauri-mcp driver-session start --port 9223Check daemon and session state
tauri-mcp daemon status
tauri-mcp driver-session status --jsonAgent Skills
This package ships one bundled Agent Skill so AI coding agents learn correct CLI usage automatically. After installing the package, wire it into your agent config:
npx @tanstack/intent@latest installBundled skill:
tauri-mcp-cli— one skill covering session lifecycle, UI automation, screenshots and inspection, IPC debugging, and mobile or remote device workflows
See the Agent Skills guide for installation options and the full coverage summary.
