Skip to content
Get packs

Node Connect Troubleshooter

Diagnoses why Brigade companion apps fail to connect or pair with a gateway and gives one fix route.

Source Download skill
Repository
spinabot/brigade
Stars
11,367
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent to troubleshoot why a phone or computer companion app (Android, iOS, macOS) cannot connect to a Brigade gateway. Instead of guessing, the agent first works out which network route is in use (same machine, local Wi-Fi, Tailscale, or public URL), runs Brigade's diagnostic commands, and matches error messages like 'pairing required' or 'bootstrap token invalid or expired' to a specific fix. It asks clarifying questions when the setup is unclear.

Great for

  • Developers who set up Brigade on a VPS or home server and cannot pair a phone with it
  • Users seeing errors such as 'pairing required', 'unauthorized', or 'bootstrap token expired' in the Brigade app
  • Anyone whose local Wi-Fi connection works but remote or Tailscale access does not

Skip it if

  • Problems unrelated to Brigade node pairing, since the troubleshooting steps only cover Brigade's gateway and device-pair setup
  • Changing production gateway security settings without review, because the fixes involve auth modes, bind addresses and public URLs that expose the gateway to the network

Try asking

  • “My Brigade Android app says 'pairing required' after scanning the QR code. What do I do?”
  • “Local Wi-Fi works but my VPS gateway won't connect from my iPhone. Help me find the right route.”
  • “The app shows 'bootstrap token invalid or expired'. Walk me through regenerating the setup code.”
  • “Should I use Tailscale Serve or bind to LAN for my macOS companion app?”
Step-by-step guide: how to use Node Connect TroubleshooterInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    node-connect.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip node-connect.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip node-connect.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent the exact error text from the app and your setup type (same Wi-Fi, Tailscale, or public URL) so it can skip guessing.
  • Run the suggested commands on the gateway host yourself first if you prefer to review output before the agent acts.
  • After any URL or auth change, generate a fresh setup code and rescan, since old codes will fail.

What's inside

  • SKILL.md

Redistributed unmodified from spinabot/brigade under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.