desktop

Diagnose Braintunnel macOS desktop issues by analyzing logs, ports, and data paths.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cirne/brain-app --skill desktop-cirne
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: desktop
Source: https://github.com/cirne/brain-app/tree/main/.cursor/skills/desktop
Command: npx skills add https://github.com/cirne/brain-app --skill desktop-cirne

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Desktop troubleshooting for Braintunnel on macOS to diagnose logs, ports, data paths, and API-key related issues in packaged apps and native shells.

Core Features & Use Cases

  • Centralized log review for macOS builds (node-server.log, Brain.log)
  • Validation of BRAIN_HOME / RIPMAIL_HOME environment paths and FDA probe status
  • Diagnostic workflow guidance for common deployment problems (DMG builds, webview 404, data path mismatches, permission issues)

Quick Start

Review the macOS log files to identify symptoms and apply the recommended diagnostics workflow.

Frequently Asked Questions about desktop

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

FAQPage Schema
How do I diagnose webview 404 errors in a Tauri macOS desktop app?

To diagnose webview 404 errors in a Tauri macOS desktop app, review centralized logs like Brain.log to identify path resolution failures and apply a guided diagnostic workflow to validate environment paths.

Why does my macOS DMG build fail during Braintunnel desktop packaging?

macOS DMG build failures during Braintunnel desktop packaging can stem from incorrect data paths or permission issues, which you can isolate by inspecting node-server.log and running port binding checks.

How does BRAIN_HOME environment path resolution affect macOS desktop diagnostics?

BRAIN_HOME environment path resolution affects macOS desktop diagnostics by determining where the application stores data, and validating this path is a required step to fix data path mismatches and permission errors.

Can I use this diagnostic workflow to fix API key handling and port binding errors on macOS?

Yes, you can use this diagnostic workflow to fix API key handling and port binding errors on macOS by running targeted checks that probe port availability and verify API key configuration in native shells.

What is the best way to troubleshoot Full Disk Access probe status for a packaged macOS app?

The best way to troubleshoot Full Disk Access probe status for a packaged macOS app is to run a diagnostic check that verifies FDA probe status and log accessibility to resolve permission errors.

How to fix incorrect data paths in Braintunnel native shells on macOS?

To fix incorrect data paths in Braintunnel native shells on macOS, validate the RIPMAIL_HOME environment variable and review centralized logs to correct mismatches in the packaged app configuration.