syncthing-cli

Configure Syncthing folders on a remote hub via REST API over SSH.

6|1|Updated May 13, 2026
One-click install
npx skills add https://github.com/Xipher-Labs/walter-os --skill syncthing-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: syncthing-cli
Source: https://github.com/Xipher-Labs/walter-os/tree/main/skills/syncthing-cli
Command: npx skills add https://github.com/Xipher-Labs/walter-os --skill syncthing-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Syncthing folder setup and reconciliation can be slow and error-prone when performed manually, especially when you need repeatable, auditable changes on a remote hub VM.

Core Features & Use Cases

  • Remote folder registration & reconciliation: Adds or confirms Syncthing folders by talking to the Syncthing REST API on the hub VM.
  • Sync health and inventory checks: Pings Syncthing for health, lists configured folders, and verifies whether a given folder ID already exists.
  • Idempotent configuration patterns: Uses deterministic request/verification flows designed to avoid duplicate or conflicting configurations.
  • Use case: When an operator needs to “register a folder” and ensure the hub is configured to receive updates from a laptop, this skill provides the REST-over-SSH workflow and safety rules.

Quick Start

Ask your AI operator to register a Syncthing folder on the hub by creating a bootstrap script that calls the Syncthing REST API over your SSH alias and sets the folder ID, label, and hub data path from your overlay environment variables.

Frequently Asked Questions about syncthing-cli

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

FAQPage Schema
How do I register a Syncthing folder on a remote hub VM using REST API?

Register a Syncthing folder by driving the Syncthing REST API through an SSH tunnel to add or confirm folder definitions, setting the folder ID, label, and hub data path from your overlay environment variables.

Can I check Syncthing sync health and list configured folders remotely via SSH?

Check sync health and list configured folders remotely by pinging the Syncthing REST API over an SSH tunnel, verifying whether a given folder ID already exists on the hub VM.

How do I make Syncthing folder configuration idempotent to avoid duplicate entries?

Make Syncthing folder configuration idempotent by using deterministic request and verification flows that check for existing folder IDs via the REST API before posting any new or updated definitions.

Do I need jq and curl to manage Syncthing folders over SSH?

Yes, you need jq locally for parsing JSON responses and curl on the hub VM to execute REST API calls, along with an operator-supplied SSH alias and an API key from secrets.env.

How do I add a receive-only folder in Syncthing for laptop-to-hub synchronization?

Add a receive-only folder for laptop-to-hub synchronization by posting a receive-only folder definition to the Syncthing REST API through an SSH tunnel after idempotent verification.

What's the best way to automate Syncthing reconciliation on a remote server?

Automate Syncthing reconciliation by creating a bootstrap script that calls the REST API over an SSH alias, applying idempotent verification before posting changes to ensure repeatable and auditable configuration.