skills.rest
nteract
nteractOFFICIAL
Explore all skills by this author →
WebsiteGitHub

automerge-sync

Synchronize Automerge document state across peers and the daemon.

158|12|Updated Feb 11, 2026
Search Tags:#debugging#sync#peer#automerge#document-model#opset#changegraph
One-click install
npx skills add https://github.com/nteract/nteract --skill automerge-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: automerge-sync
Source: https://github.com/nteract/nteract/tree/main/.agents/skills/automerge-sync
Command: npx skills add https://github.com/nteract/nteract --skill automerge-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers understand, debug, and reason about Automerge-based synchronization between peers, the document model, and the daemon within nteract.

Core Features & Use Cases

  • Inspect the core Automerge data structures (OpSet, ChangeGraph, ActorId) and the per-peer sync state to diagnose convergence issues.
  • Debug sync failures, adjust reconnection logic, examine document structure, diagnose panics in op application, and evaluate architectural patterns from automerge-repo and samod.
  • Explore runtime interactions, recovery workflows, and versioned sync protocols to guide design decisions for new sync streams or protocol improvements.

Quick Start

Provide a targeted debugging scenario by loading the Automerge document state and querying OpSet and ChangeGraph to trace changes and identify divergence.

Frequently Asked Questions about automerge-sync

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

FAQPage Schema
How do I debug Automerge sync failures and peer divergence?▼

Diagnose Automerge sync failures by inspecting OpSet, ChangeGraph, and ActorId data structures to trace changes across peers. Querying per-peer sync state helps pinpoint convergence issues and document structure anomalies.

Why does my Automerge document panic during op application?▼

Automerge document panics during op application stem from inconsistent shared notebook state or transport breaks. Diagnose these runtime panics by examining the document model and resetting or rebuilding per-peer sync state to restore synchronization.

What is the best way to add new sync streams in Automerge?▼

The best way to add new sync streams in Automerge involves evaluating architectural patterns from automerge-repo and samod. This approach guides design decisions for versioned sync protocols and helps maintain consistent shared notebook states across peers.

How do I recover Automerge sync state when transport breaks?▼

Recover Automerge sync state when transport breaks by executing reset and rebuild workflows. These recovery actions re-establish a consistent shared notebook state across peers and the daemon by clearing corrupted per-peer sync states and resynchronizing the document.

Can I inspect Automerge OpSet and ChangeGraph to reason about convergence?▼

Yes, you can inspect Automerge OpSet and ChangeGraph internals to reason about convergence. Tracing changes through these core data structures and ActorId allows you to diagnose whether peers have successfully synchronized their document state.

Related Skills

Explore More Software Engineering Skills→
TeoSlayerTeoSlayer
7

pilot-mesh-status

Aggregate daemon health, peer status, and bandwidth data from pilotctl.

Community
Advanced
solitasrohsolitasroh
2

rollback

Create, list, and restore PDCA checkpoints with rollback commands.

Community
Advanced
joeblew999joeblew999

automerge

Sync documents across peers with Automerge CRDTs for offline-first collaboration.

Community
Advanced
sitapixsitapix

automerge-swift-diag

Diagnose Automerge Swift runtime errors with symptom-based fixes.

Community
Advanced