troubleshoot-m4-ovh-sync

Diagnose rsync sync failures between Mac M4 and OVH over Cloudflare Tunnel.

5|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill troubleshoot-m4-ovh-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot-m4-ovh-sync
Source: https://github.com/rafael-fae/agent-ops-worflow/tree/main/archive/skills/operacao/troubleshoot-m4-ovh-sync
Command: npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill troubleshoot-m4-ovh-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and resolve failures in a legacy rsync-based synchronization workflow between an M4 Mac and OVH via Cloudflare Tunnel, especially when transfers drop, permissions break, or macOS rsync compatibility causes errors.

Core Features & Use Cases

  • Connection Drop Troubleshooting: Investigates intermittent tunnel failures, unexpected end-of-file errors, and bulk transfer instability.
  • macOS rsync Compatibility Checks: Identifies openrsync limitations such as missing append-verify support and recommends compatible flags.
  • Permission and Cron Diagnostics: Handles iCloud Drive access issues, symlink validation, and scheduled sync behavior on macOS.
  • Use Case: A teammate reports sync failures in the Hermes environment, and you need to quickly determine whether the cause is tunnel saturation, rsync flag incompatibility, or filesystem permission constraints.

Quick Start

Ask for a diagnosis of the latest sync-rsync.log error and a recommendation for the correct rsync flags to use on macOS through the Cloudflare Tunnel.

Frequently Asked Questions about troubleshoot-m4-ovh-sync

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

FAQPage Schema
Why does rsync fail over Cloudflare Tunnel on macOS?

rsync over Cloudflare Tunnel on macOS often fails due to intermittent tunnel saturation, unexpected end-of-file errors, or macOS openrsync limitations causing bulk transfer instability. Diagnosing sync-rsync logs helps identify whether the cause is network drops or flag incompatibility.

How do I fix openrsync compatibility errors on Mac M4?

To fix openrsync compatibility errors on Mac M4, you must identify missing flag support like append-verify and apply retry-friendly transfer flags recommended for macOS to ensure stable synchronization over the network.

Does macOS openrsync support append-verify for rsync transfers?

macOS openrsync does not fully support append-verify, which causes legacy rsync synchronization pipelines to break. You need to apply tunnel-safe rsync settings and compatible flags to resolve transfer errors effectively.

How to troubleshoot iCloud Drive permission errors during cron sync?

To troubleshoot iCloud Drive permission errors during cron sync, validate filesystem paths for iCloud-backed vaults, check symlink validation, and diagnose scheduled sync behavior on macOS to isolate access issues.

What are the best rsync flags to use through Cloudflare Tunnel?

The best rsync flags for Cloudflare Tunnel are tunnel-safe settings with retry-friendly transfer flags. These prevent connection drops and bulk transfer instability when synchronizing data over the network infrastructure.

Why is my cron-based rsync job not working on macOS?

Your cron-based rsync job might not be working on macOS due to broken permissions, iCloud Drive access issues, or openrsync compatibility limitations. Analyzing sync-rsync logs helps isolate the specific failure.