Suture Onboarding Guide

First-Time User Experience

Step 1: Install

curl -sSL https://suture.dev/install.sh | sh

Step 2: Initialize a Repository

mkdir my-project && cd my-project
suture init

Step 3: Make Changes

Edit any structured files (JSON, YAML, TOML, CSV, etc.)

Step 4: Commit

suture add .
suture commit "my first structured commit"

Step 5: Branch & Merge

suture checkout -b feature
# make changes on both branches
suture merge main
# Semantic merge resolves conflicts automatically!

Step 6: View History

suture log --graph
suture diff main..HEAD

CI/CD Integration

Add to .github/workflows/merge.yml:

steps:
  - uses: WyattAu/suture/.github/actions/merge@v5
    with:
      formats: "json,yaml,toml,csv"