node-connect

Diagnose and resolve Alisio node connection and pairing issues.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/nuno7lopes/alisio --skill node-connect-nuno7lopes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: node-connect
Source: https://github.com/nuno7lopes/alisio/tree/main/skills/node-connect
Command: npx skills add https://github.com/nuno7lopes/alisio --skill node-connect-nuno7lopes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The node-connect skill helps diagnose and fix issues related to the Alisio node connection and pairing process, ensuring smooth communication between the Alisio app and the backend system.

Core Features & Use Cases

  • Diagnosis: Identify common issues like incorrect network configuration, invalid pairing tokens, or unreachable gateways.
  • Routing Analysis: Verify if Alisio is correctly advertising network routes and if they are correctly configured.
  • Quick Fixes: Provide immediate solutions for common problems such as enabling Tailscale Serve or setting up a proper public URL.
  • Use Case: If users encounter issues connecting to the Alisio app, this skill can help pinpoint and resolve the problem.

Quick Start

Run the node-connect skill to diagnose the connection issue with your Alisio node and follow the suggested steps to resolve it.

Frequently Asked Questions about node-connect

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

FAQPage Schema
How do I diagnose Alisio node connection issues during app pairing?

To diagnose Alisio node connection issues, run the node-connect skill to identify incorrect network configurations, invalid pairing tokens, or unreachable gateways. It pinpoints problems with QR code scanning and manual pairing to restore communication.

Why does my Alisio remote connection fail after scanning the QR code?

Alisio remote connections fail when network routing is incorrectly advertised or gateways are unreachable. The node-connect skill analyzes your routing configuration and checks if Tailscale Serve or a proper public URL is enabled to resolve the block.

What do I need to configure before troubleshooting an Alisio network routing failure?

Troubleshooting Alisio network routing failures requires knowledge of Alisio's internal configuration and networking setup. You need access to the backend system to verify gateway availability and network route advertising.

What is the best way to fix an unreachable Alisio gateway?

The best way to fix an unreachable Alisio gateway is to run the node-connect skill for quick fixes. It verifies gateway configuration and suggests enabling Tailscale Serve or setting up a proper public URL to restore access.

Can I use Tailscale Serve to resolve Alisio manual pairing problems?

Yes, you can use Tailscale Serve to resolve Alisio manual pairing problems. The node-connect skill identifies when this service is needed and provides immediate steps to enable it for proper public URL routing.