suture-hub 5.3.0

Install · Quick Start · Docs · API · Pricing

Why Suture?

Git's merge is line-based. When two branches change different keys in a JSON file, Git reports a conflict — even though there's no actual conflict.

Before (Git):

<<<<<<< HEAD
  "version": "5.1.0",
  "features": ["merge", "diff", "platform"]
=======
  "license": "AGPL-3.0"
>>>>>>> feature

After (Suture):

{
  "version": "5.1.0",
  "features": ["merge", "diff", "platform"],
  "license": "AGPL-3.0"
}

Installation

curl -fsSL https://raw.githubusercontent.com/WyattAu/suture/main/install.sh | sh

Git Merge Driver (5 seconds)

curl -fsSL https://raw.githubusercontent.com/WyattAu/suture/main/scripts/install-merge-driver.sh | bash

That's it. Git will now automatically merge: *.json *.yaml *.yml *.toml *.xml *.csv

Quick Start

suture init my-project && cd my-project
suture branch feature/json-config
suture checkout feature/json-config
# ... edit config.json ...
suture add config.json
suture commit "update config"
suture merge main          # structured conflicts resolved automatically
suture remote add origin http://localhost:50051/my-project
suture push origin

Supported Formats

CLI Commands

init · clone · status · add · rm · mv · commit · log · diff · show · branch · checkout · merge · rebase · tag · stash · push · pull · fetch · remote · lfs · blame · grep · cherry-pick · revert · reset · bisect · worktree · config · doctor · key · verify · export · archive · tui · git import · sync

suture --help          # full command list
suture drivers         # list available merge drivers
suture completions bash > ~/.bash_completion.d/suture

API

curl -X POST https://api.suture.dev/api/merge \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "driver": "json",
    "base": "{\"name\": \"base\"}",
    "ours": "{\"name\": \"ours\"}",
    "theirs": "{\"name\": \"theirs\"}"
  }'

Full API Reference

Pricing

Self-hosted is always free (AGPL-3.0).

Platform Features

• Semantic merge API — REST endpoint for all 18 format drivers
• WASM plugin system — custom merge drivers in any language
• OAuth — Google and GitHub sign-in
• Organizations — teams with role-based access (owner/admin/member/viewer)
• Analytics — merge metrics, conflict rates, driver usage
• Stripe billing — checkout sessions, customer portal, webhook handling
• Rate limiting — per-endpoint protection

Self-Hosted Hub

docker compose up -d
# Hub available at http://localhost:8080

See Self-Hosting Guide for Docker, binary, Kubernetes, and systemd deployment.

GitHub Actions

- uses: WyattAu/suture/.github/actions/merge@main
  with:
    files: |
      package.json
      tsconfig.json
    base-ref: ${{ github.event.pull_request.base.sha }}

VS Code Extension

Install from the VS Code Marketplace: conflict highlighting, one-click auto-merge, status bar integration.

Documentation

User Guide · API Reference · Self-Hosting · Deployment · CI Integration

Architecture

suture/
├── crates/
│   ├── suture-core/            # Merge engine (342 tests)
│   ├── suture-driver-*/        # 18 format drivers
│   ├── suture-cli/             # CLI (115 tests)
│   ├── suture-hub/             # Coordination server (50 tests)
│   ├── suture-platform/        # Hosted SaaS (REST API, billing, auth)
│   ├── suture-raft/            # Consensus (48 tests)
│   ├── suture-vfs/             # FUSE filesystem
│   ├── suture-wasm-plugin/     # WASM plugin system
│   ├── suture-tui/             # Terminal UI (37 tests)
│   └── suture-lsp/             # Language server (25 tests)
├── desktop-app/                # Tauri desktop app
├── vscode-extension/           # VS Code extension
├── templates/                  # .gitattributes templates
├── scripts/                    # Install scripts
└── deploy/                     # Helm chart, Docker

License

• Self-hosted: AGPL-3.0 (free forever)
• Commercial: Suture Commercial License