Tutorials on Mergeway

Build your first Mergeway repository

Mon, 01 Jan 0001 00:00:00 +0000

Build your first Mergeway repository

In this tutorial you will install mergeway-cli v0.10.0 for Linux x86_64, copy the tag-matched examples/full fixture, inspect its entities and records, create a blog post related to existing records, validate the repository, and export it as JSON.

The commands work in a temporary learning directory. They do not modify the source fixture.

Before you begin

You need a Linux x86_64 shell with curl and tar. For another supported platform, follow Install Mergeway tools and return after mergeway-cli version works.

Review your first semantic change

Mon, 01 Jan 0001 00:00:00 +0000

Review your first semantic change

In this tutorial you will create a disposable Git repository from Mergeway’s examples/full, make three kinds of record change, validate them, and review the result with mergeway-diff. Nothing writes to your source checkout.

Prerequisites

Git.
mergeway-cli and mergeway-diff v0.10.0 on PATH; use Install Mergeway tools if needed.
A downloaded v0.10.0 source archive, which supplies the fixed examples/full starting state used by this tutorial.

1. Create a temporary repository

From the extracted source archive, copy the fixture and initialize only the copy:

Inspect a repository with an AI client

Mon, 01 Jan 0001 00:00:00 +0000

Inspect a repository with an AI client

In this tutorial, Codex launches mergeway-mcp over stdio and inspects the fixed examples/full repository. The server cannot modify records, and the allow-list exposes only User and Post.

Prerequisites

Codex CLI with local stdio MCP support.
mergeway-cli and mergeway-mcp v0.10.0 on PATH.
A v0.10.0 source archive containing examples/full.

1. Validate and locate the repository

From the extracted source archive:

mergeway-cli --root examples/full validate
cd examples/full
pwd
command -v mergeway-mcp

Expect status: validation succeeded. Save the two absolute paths printed by pwd and command -v.