---
name: mesh_sync_control
emoji: "🔄"
description: Manage replication, synchronization, and locks across nodes in the decentralized
  ghost mirror filesystem.
skill_type: local
is_enabled: true
features:
- swarm_control
- agent_harness
config:
  actions:
  - start
  - stop
  - lock
  - unlock
  - resync
  parameters:
    type: object
    properties:
      action:
        type: string
        enum:
        - start
        - stop
        - lock
        - unlock
        - resync
        description: Control action.
      node_id:
        type: string
        description: Target node ID.
      session_id:
        type: string
        description: The workspace session ID to manage.
      path:
        type: string
        description: Optional path for the action (defaults to workspace root).
    required:
    - action
    - node_id
    - session_id
is_system: true
---

# Mesh Sync Control

Use this tool to manage the synchronization state of files across the swarm.
1. **`start`**: Instruct a node to begin watching and syncing a local directory.
2. **`lock`**: Disable user-side file watcher on a node. Use this BEFORE starting multi-file refactors to prevent race conditions.
3. **`unlock`**: Restore user-side sync after an AI refactor is complete.
4. **`resync`**: Force a node to perform a full hash-based reconciliation against the master mirror on the Hub.
