\n\nQuick Guide: Define commands with
\n#[tauri::command], register ingenerate_handler![]. UseState<T>for shared state (wrap mutable fields inMutex). Error types must implement bothserde::SerializeandDisplay-- usethiserrorfor ergonomic error enums. Async commands run on Tokio -- borrowed args (&str,State<'_, T>) requireResult<T, E>return type. Stream data to frontend viaChannel<T>(not events) for high throughput. Emit events withapp.emit()for fire-and-forget notifications.Current version: Tauri 2.x (stable). Async runtime is Tokio.
\n
<critical_requirements>
\n\n\nAll code must follow project conventions in CLAUDE.md (kebab-case, named exports, import ordering,
\nimport type, named constants)
(You MUST register every command in tauri::generate_handler![] -- unregistered commands compile fine but silently fail at runtime)
(You MUST implement serde::Serialize on all error types returned from commands -- Tauri serializes errors across the IPC boundary)
(You MUST wrap mutable managed state in Mutex or RwLock -- commands run concurrently and State<T> requires Send + Sync)
(You MUST return Result<T, E> from async commands that use borrowed args (&str, State<'_, T>) -- Rust lifetime rules require it)
(You MUST use Channel<T> for streaming data to frontend -- events are designed for small payloads, not high-throughput streaming)
</critical_requirements>
\nAuto-detection: #[tauricommand], tauricommand, tauriState, AppHandle, app.manage, generate_handler, tauriipcChannel, Emitter, Listener, thiserror, tauritest, mock_builder, async tauri command, tauri error handling, tauri state management
\nWhen to use:
\napp.manage() and State<T>When NOT to use:
\nKey patterns covered:
\n#[tauri::command] (examples/core.md)thiserror + manual Serialize impl (examples/core.md)Mutex/RwLock and State<T> injection (examples/core.md)AppHandle for accessing app resources from commands (examples/core.md)Detailed resources:
\n<decision_framework>
\nHow should this command be structured?\n|-- Fast, CPU-only, no I/O?\n| +-- Sync command: #[tauri::command] fn\n|-- Involves file, network, or long computation?\n| +-- Async command: #[tauri::command] async fn -> Result<T, E>\n|-- Needs shared app state?\n| +-- Add State<T> parameter, register with .manage()\n|-- Needs app paths, windows, or event emission?\n| +-- Add AppHandle parameter, import Manager trait\n|-- Needs to stream data back to frontend?\n| +-- Add Channel<T> parameter\n+-- Needs raw request headers or binary body?\n +-- Add tauri::ipc::Request parameter\nHow should Rust communicate with the frontend?\n|-- Request/response (frontend asks, Rust answers)?\n| +-- Command (invoke from frontend, return value)\n|-- Ordered stream from a specific operation?\n| +-- Channel<T> parameter in a command\n|-- Fire-and-forget notification (broadcast)?\n| +-- Event: app.emit() or app.emit_to()\n+-- Need to run JS in the webview?\n +-- webview.eval() (escape hatch, avoid if possible)\nHow should this command handle errors?\n|-- Quick prototype or simple command?\n| +-- Result<T, String> with .map_err(|e| e.to_string())\n|-- Production command with multiple error sources?\n| +-- Custom error enum with thiserror + manual Serialize impl\n|-- Truly unrecoverable (corrupt state, invariant violation)?\n| +-- panic! (but never unwrap() on expected errors)\nHow should state be wrapped?\n|-- Read-only config set once at startup?\n| +-- No wrapper needed: app.manage(Config { ... })\n|-- Read-heavy, infrequent writes?\n| +-- RwLock<T>: multiple concurrent readers, exclusive writer\n|-- Frequent reads and writes, simple fields?\n| +-- Mutex<T>: exclusive access for both reads and writes\n+-- Need to hold lock across .await points?\n +-- tokio::sync::Mutex (not std::sync::Mutex)\n</decision_framework>
\n<red_flags>
\nHigh Priority Issues:
\nunwrap() in commands instead of returning Result -- panics crash the command handler, frontend gets a generic error with no detailsgenerate_handler![] -- compiles fine, silently fails at runtimeserde::Serialize on error types -- compilation error, but the fix is non-obvious (manual impl, not derive)std::sync::Mutex and holding the lock across .await -- blocks the Tokio runtime, causes deadlocks. Use tokio::sync::Mutex when you need to hold across await points.manage(T) registration -- runtime panic when a command tries to access State<T>Serialize on error enums -- produces variant-structure JSON ({\"Io\": {...}}) instead of a readable stringMedium Priority Issues:
\nChannel<T>tauri::Emitter when calling .emit() -- compilation error with confusing message about missing methodOption<()> from commands -- serializes as null which the frontend may not expect (serde serialization/deserialization asymmetry)Gotchas & Edge Cases:
\nasync fn cmd(name: &str) without Result return type fails to compile. Either use String or return Result<T, E>invokeMessage), Rust receives snake_case (invoke_message) by default. Use #[tauri::command(rename_all = \"snake_case\")] to change thisState<T> parameters are not passed from frontend -- they are injected by Tauri. Mixing up \"frontend args\" and \"injected params\" in the function signature is confusing but works (Tauri filters them)lock().unwrap() panics if a previous holder panicked. In production, handle PoisonError or use lock().expect(\"state lock poisoned\").manage(T) call registers a separate type. State<Mutex<AppState>> and State<AppState> are different registrationsChannel<T> is tied to the command invocation. It cannot be stored for later use outside the commandSerialize + Clone. serde_json::Value works as a catch-all but loses type safetyemit_to target: Target is a webview label string. If the webview does not exist, the event is silently dropped</red_flags>
\n<critical_reminders>
\n\n\nAll code must follow project conventions in CLAUDE.md (kebab-case, named exports, import ordering,
\nimport type, named constants)
(You MUST register every command in tauri::generate_handler![] -- unregistered commands compile fine but silently fail at runtime)
(You MUST implement serde::Serialize on all error types returned from commands -- Tauri serializes errors across the IPC boundary)
(You MUST wrap mutable managed state in Mutex or RwLock -- commands run concurrently and State<T> requires Send + Sync)
(You MUST return Result<T, E> from async commands that use borrowed args (&str, State<'_, T>) -- Rust lifetime rules require it)
(You MUST use Channel<T> for streaming data to frontend -- events are designed for small payloads, not high-throughput streaming)
Failure to follow these rules will cause silent command failures, runtime panics, deadlocked async runtimes, or unserializable error types.
\n</critical_reminders>
\n","files":[{"path":"examples/core.md","sizeBytes":11520,"isText":true},{"path":"examples/events.md","sizeBytes":5960,"isText":true},{"path":"examples/testing.md","sizeBytes":6238,"isText":true},{"path":"reference.md","sizeBytes":7587,"isText":true},{"path":"SKILL.md","sizeBytes":16533,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-29T15:29:46.102863Z","sha256":"1C58E4E84A38E75D58A6E1F7606AC396E8A96659D6C00DA6B0B59DEFD1FF1999","sizeBytes":16856},"review":null,"source":{"repositoryUrl":"https://github.com/agents-inc/skills","path":"dist/plugins/desktop-backend-tauri/skills/desktop-backend-tauri","license":"MIT","commit":"3a51ef571e996b18294bf776d53dbdad26de0617","subtreeSha":"2A40524B62D61667FCFE8BD5F85F79D4D40FFDE10CC0E17F6EABA52235EA63AD","lastSyncedAt":"2026-09-29T15:27:48.914434Z"},"reviewedAt":"2026-09-29T15:33:47.369505Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/agents-inc/skills/tree/main/dist/plugins/desktop-backend-tauri/skills/desktop-backend-tauri"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install agents-inc-skills@llmmart"},{"target":"git","command":"git clone https://github.com/agents-inc/skills.git"}]}