am_fork: Fork an Automerge document

View source: R/document.R

am_forkR Documentation

Fork an Automerge document

Description

Creates a fork of an Automerge document at the current heads or at a specific point in history. The forked document shares history with the original up to the fork point but can diverge afterwards.

Usage

am_fork(doc, heads = NULL)

Arguments

doc

An Automerge document

heads

Optional list of change hashes to fork at a specific point in the document's history. If NULL (default) or an empty list, forks at current heads. Each hash should be a raw vector (32 bytes).

Value

A new Automerge document (fork of the original)

Examples

doc1 <- am_create()
doc2 <- am_fork(doc1)

# Now doc1 and doc2 can diverge independently
am_close(doc1)
am_close(doc2)


automerge documentation built on Feb. 5, 2026, 5:08 p.m.