LogoMergeway
    • browseComponents
      • Specification component
      • CLI
      • Diff
      • Python SDK
      • MCP
      • LSP
      • VS Code
    • rocket_launchTutorials
      • Build your first Mergeway repository
      • Review your first semantic change
      • Inspect a repository with an AI client
    • lightbulbHow-to guides
      • Install Mergeway tools
        • Reuse a JSON Schema
        • Load records with JSONPath
        • Model inheritance and reference unions
        • Derive identifiers and fields from paths
        • Load Open Knowledge Format documents
        • Create, inspect, update, and delete records
        • Validate configuration or a repository
        • Split schemas and records across files
        • Validate a repository in GitHub Actions
        • Enforce canonical formatting with pre-commit
        • Export repository data
        • Generate an entity-relationship diagram
        • Format safely in CI
        • Troubleshoot the CLI
        • Compare the working tree with HEAD
        • Compare two Git revisions
        • Publish a semantic change summary
        • Consume JSON diff output in automation
        • Troubleshoot semantic diff
        • Connect Codex over stdio
        • Restrict MCP to selected entities
        • Serve MCP over HTTP
        • Troubleshoot MCP connections and stdout
        • Configure Neovim
        • Configure a generic LSP client
        • Capture LSP debug logs
        • Troubleshoot diagnostics and navigation
      • Python SDK guides
        • Install the Python SDK
        • Get started with mergeway-python
    • developer_guideReference
        • Overview
        • Terminology
        • Conformance and requirement language
        • Repository and configuration
        • Entity definitions
        • Field definitions and types
        • Records and data sources
        • Identifiers and references
        • Validation and error model
        • JSON Schema interoperability
        • Path-derived data
        • Open Knowledge Format mapping
        • Changelog and migration notes
        • mergeway-cli init
        • mergeway-cli validate
        • mergeway-cli version
        • mergeway-cli entity list
        • mergeway-cli entity show
        • mergeway-cli fmt
        • mergeway-cli config lint
        • mergeway-cli config export
        • mergeway-cli gen-erd
        • mergeway-cli list
        • mergeway-cli files
        • mergeway-cli get
        • mergeway-cli create
        • mergeway-cli update
        • mergeway-cli delete
        • mergeway-cli export
          • MCP transports
          • MCP tools
        • mergeway-lsp reference
        • owlExplanation
          • Why metadata as code?
          • The Mergeway repository model
          • The validation model
          • Semantic diff versus file diff
          • MCP access and security
          • Editor architecture
          • Schema design choices
          • Component architecture
        • assignmentProject
          • Documentation authoring
          • GitHub
          • Releases
          • Contributing
          • MIT License
        Diff tasks

        Diff tasks

        Use these guides after your repository is valid and committed to Git:

        • Compare the working tree with HEAD.
        • Compare two Git revisions.
        • Publish a semantic change summary.
        • Consume JSON diff output in automation.

        For exact flags, snapshot boundaries, output fields, and failures, use the mergeway-diff reference.

        Calendar October 20, 2026
        Backward Troubleshoot the CLI Compare the working tree with HEAD Forward