automerge-swift-core

Manipulate Automerge documents from Swift using ObjId-based operations.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/sitapix/automerge-swift-skills --skill automerge-swift-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: automerge-swift-core
Source: https://github.com/sitapix/automerge-swift-skills/tree/main/skills/automerge-swift-core
Command: npx skills add https://github.com/sitapix/automerge-swift-skills --skill automerge-swift-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Automerge Swift Core Document API provides low-level, high-performance access to the Automerge CRDT, enabling direct manipulation of the document tree using ObjId-based operations and offering precise control over maps, lists, and text.

Core Features & Use Cases

  • Create and mutate Automerge documents with full access to ObjId-based operations (putObject, insertObject, text, delete).
  • Navigate and inspect the document structure, including maps, lists, and text, with helpers for paths and object types.
  • Use when performance and fine-grained control are required over frequent updates versus higher-level Codable abstractions.

Quick Start

Initialize an empty Automerge Document and build a nested map with a list of contacts.

Frequently Asked Questions about automerge-swift-core

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

FAQPage Schema
How do I manipulate Automerge documents directly in Swift?

You can manipulate Automerge documents in Swift using the core API's ObjId-based operations like putObject, insertObject, and delete to directly mutate nested document structures.

When should I use the Automerge core API instead of Codable abstractions in Swift?

Use the Automerge core API in Swift when you need high performance and fine-grained control over frequent document updates, bypassing higher-level Codable abstractions for direct CRDT manipulation.

How do I create and mutate nested maps and lists in an Automerge document?

You create and mutate nested maps and lists in an Automerge document by initializing an empty document and applying core API operations like putObject and insertObject to build the tree structure.

Can I debug low-level CRDT behavior using the Automerge Swift core API?

Yes, you can debug low-level CRDT behavior using the Automerge Swift core API by utilizing navigation helpers to traverse, inspect, and verify the document tree structure and object types.

Does the Automerge Swift core API support document lifecycle management?

Yes, the Automerge Swift core API supports document lifecycle management by providing methods like save and fork to persist and branch document states during runtime operations.

What are the limitations of using ObjId-based operations for Automerge documents?

Using ObjId-based operations for Automerge documents requires manual object tracking and navigation, adding operational complexity compared to automated higher-level data binding abstractions.