aiskillstore/marketplace / skills/8beeeaaat/debug-tauri
debug-tauri
VerifiedAutomates Tauri WebView debugging using official plugins (tauri-plugin-log + screenshots) with process verification, automated screenshots, console logs, and state analysis. Use when debugging Tauri apps, investigating WebView issues, analyzing runtime errors, or troubleshooting UI problems.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.8 KB |
| references/IPC_COMMANDS.md | markdown | 3.9 KB |
| references/LOGGING.md | markdown | 4.8 KB |
| references/MIGRATION.md | markdown | 10.4 KB |
| references/REFERENCE.md | markdown | 5.2 KB |
| references/REPORT_TEMPLATE.md | markdown | 3.1 KB |
| references/SCREENSHOTS.md | markdown | 4.0 KB |
| references/TROUBLESHOOTING.md | markdown | 2.8 KB |
| scripts/analyze_logs.shexecutable | script | 3.6 KB |
| scripts/capture.shexecutable | script | 2.4 KB |
| scripts/validate_setup.shexecutable | script | 4.9 KB |
| skill-report.json | config | 225.7 KB |
references/REFERENCE.md
View on GitHub# Tauri WebView Debugger - Detailed Reference
## Table of Contents
- Tauri IPC command list
- macOS screencapture commands
- WebGPU Debug API (planned for Phase 4)
- Process information
- Troubleshooting
- File path references
- Reference links
## Tauri IPC command list
### capture_webview_state
Get the WebView internal state as JSON.
**TypeScript implementation:**
```typescript
import { captureWebViewState } from "@/lib/debugBridge";
const state = await captureWebViewState();
console.log(state);
```
**Response example:**
```json
{
"url": "http://localhost:5173",
"title": "iori",
"user_agent": "TauriWebView/2.0",
"viewport": {
"width": 1200,
"height": 800
}
}
```
### get_console_logs
Get console logs (currently returns an empty array).
**Future implementation:**
Hook `console.log` and similar calls on the frontend and send as Tauri events.
### send_debug_command
Send a debug command to the WebView (event-based).
**Example:**
```typescript
import { sendDebugCommand } from "@/lib/debugBridge";
await sendDebugCommand("get_gpu_state", { includeBuffers: true });
```
### copy_screenshot_to_debug_dir
Copy a screenshot file to the debug-tools screenshots directory.
**TypeScript implementation:**
```typescript
import { copyScreenshotToDebugDir } from "tauri-plugin-debug-tools/debugBridge";
const result = await copyScreenshotToDebugDir("/path/to/screenshot.png");
console.log(result.destination_path);
// ~/Library/Logs/<bundle-id>/debug-tools/screenshots/1740145200_screenshot.png
```
**Response example:**
```json
{
"source_path": "/path/to/original/window-1.png",
"destination_path": "/Users/you/Library/Logs/com.example.app/debug-tools/screenshots/1740145200_window-1.png"
}
```
## Screenshot Capture
Screenshots are captured using `tauri-plugin-screenshots` and optionally copied to `debug-tools/screenshots/`.
### Capture main window (recommended)
```typescript
import { captureMainWindowToDebugDir } from "tauri-plugin-debug-tools/screenshotHelper";
// Capture and copy to debug directory in one step
const path = await captureMainWindowToDebugDir();
// Saved to: debug-tools/screenshots/1740145200_window-1.png
```
### Capture without copying
```typescript
import { captureMainWindow } from "tauri-plugin-debug-tools/screenshotHelper";
const path = await captureMainWindow();
// Saved to: app_data_dir/tauri-plugin-screenshots/window-1.png
```
## Legacy: macOS screencapture commands
### Full screen capture
```bash
screencapture -x -T 0 /tmp/screenshot.png
```
**Options:**
- `-x`: Disable sound
- `-T <seconds>`: Delay (0 = immediate)
### Specify a window ID for a specific process
```bash
# Get the window ID
osascript -e 'tell application "System Events" to get unix id of first process whose name is "<app-binary-name>"'
# Capture using that ID
screencapture -l <window-id> /tmp/tauri_window.png
```
## WebGPU Debug API (planned for Phase 4)
### captureWebGPUState()
Capture WebGPU state comprehensively.
**Return value:**
```typescript
{
deviceInfo: GPUAdapterInfo,
bufferStats: {
particleBuffer: { size: number, usage: number },
uniformBuffer: { size: number, usage: number },
},
computeResults: Float32Array,
performanceMetrics: {
fps: number,
frameTime: number,
memoryUsage: number
}
}
```
### getDeviceInfo()
Get GPU device information.
```typescript
const info = await getDeviceInfo();
// { vendor: "Apple", architecture: "..." }
```
### exportComputeResults()
Export compute shader results to the CPU.
```typescript
const results = await exportComputeResults();
// Float32Array(100000) - particle position data
```
### getPerformanceMetrics()
Get performance metrics.
```typescript
const metrics = await getPerformanceMetrics();
// { fps: 60, frameTime: 16.67, memoryUsage: 197 }
```
## Process information
### Check running Tauri processes
```bash
ps aux | grep <app-binary-name> | grep -v grep
```
**Example output:**
```
user 94678 1.6 0.3 440546784 197920 s011 S+ 11:47AM 0:12.85 target/debug/<app-binary-name>
```
### Process details
```bash
ps -p 94678 -o pid,vsz,rss,%cpu,%mem,command
```
## Troubleshooting
### Error: "Main window not found"
**Cause**: The main window is not running or the label differs.
**Fix:**
1. Ensure the app is running (e.g. `tauri dev`)
2. Ensure `tauri.conf.json` has `windows.label` set to "main"
### Error: "Process not found"
**Cause**: The target process is not running.
**Fix:**
```bash
# Example: from the project root
tauri dev
```
### Screenshot cannot be captured
**Cause**: Screen recording is not allowed in macOS privacy settings.
**Fix:**
1. System Settings > Privacy & Security > Screen Recording
2. Select Screen Recording
3. Add Terminal (or the launcher) to the allowed list
## File path references
### Reference (optional)
- If there is a debug command implementation such as `src-tauri/src/commands/debug.rs`, you can collect logs with `append_debug_logs` and similar commands.
- If you provide a frontend bridge like `src/lib/debugBridge.ts`, it becomes easier to fetch state via IPC.
## Reference links
- [Tauri IPC Commands](https://v2.tauri.app/develop/calling-rust/)
- [Claude Code Skills Documentation](https://code.claude.com/docs/ja/skills)
- [macOS screencapture man page](https://ss64.com/osx/screencapture.html)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |