tauri-sidecar-troubleshoot

Diagnose and fix Bun-based Tauri sidecar issues across development and production modes.

2|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/bradhannah/doggy-bag --skill tauri-sidecar-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tauri-sidecar-troubleshoot
Source: https://github.com/bradhannah/doggy-bag/tree/main/.opencode/skill/tauri-sidecar-troubleshoot
Command: npx skills add https://github.com/bradhannah/doggy-bag --skill tauri-sidecar-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers diagnose and fix Tauri sidecar issues across development and production modes.

Core Features & Use Cases

  • Dual-mode troubleshooting: Debugs Bun-based sidecars that run in development (Bun) or production (compiled binary) modes.
  • Common problems & resolutions: Addresses route Not Found, stale incremental caches, and port detection problems with step-by-step guidance.
  • Guided remediation: Provides concrete commands and checks to restore correct sidecar behavior in a Tauri application.

Quick Start

Use this skill to diagnose and fix a failing Bun-based Tauri sidecar in a local development environment.

Frequently Asked Questions about tauri-sidecar-troubleshoot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a Tauri sidecar route Not Found error?

To fix a Tauri sidecar route Not Found error, you must diagnose routing issues between your Tauri shell and the sidecar process. This involves checking your Rust configuration and verifying that the sidecar binary is correctly serving the expected endpoints.

Why does my Bun sidecar fail in production but work in development?

Your Bun sidecar fails in production due to dual-mode behavior differences between running the Bun runtime and executing the compiled binary. Diagnosing this requires checking your Tauri configuration and verifying that the compiled sidecar binary handles routing correctly.

How do I resolve stale incremental cache issues with Tauri sidecars?

To resolve stale incremental cache issues with Tauri sidecars, you must clear the existing cache and rebuild the sidecar binary. This ensures your Bun-based sidecar uses the most recent code and configuration instead of outdated cached files.

Do I need to know Rust to troubleshoot Tauri sidecar port detection problems?

Yes, understanding Rust is required to troubleshoot Tauri sidecar port detection problems effectively. You also need knowledge of Bun and Tauri configuration, plus access to Makefile targets and sidecar binaries to implement the necessary port detection remedies.

What is the best way to debug a failing Bun-based sidecar in a local Tauri environment?

The best way to debug a failing Bun-based sidecar in a local Tauri environment is to follow guided remediation steps. This involves running specific Makefile targets and checks to diagnose routing, cache, and port detection issues across development and production modes.