Gitslice docs

Start Here

Use this path if you want to get productive before learning the whole model. Gitslice gives you repository-like slices over one global source graph, and changesets are how work lands.

First workflow

  1. 1

    Install gs

    One command for Linux and macOS: downloads the latest prebuilt binary, verifies its checksum, and installs it to ~/.local/bin. For Windows, go install, or building from source, see the CLI Reference.

    curl -fsSL https://gitslice.io/install.sh | sh
    gs version
  2. 2

    Sign in

    Authenticate once, then use the same identity for CLI and web.

    gs auth login
    gs auth status
  3. 3

    Open your home slice

    Your personal account has a `home` slice rooted at /<you>. Use it for a first workflow.

    gs init <you>:home
    # example: gs init nic:home
  4. 4

    Make a local edit

    Edit files normally, then inspect what the workspace will send.

    gs status
    gs diff
  5. 5

    Create and submit a changeset

    A changeset is the review and submit unit. When it lands, it is included in the accepted main tree.

    gs create --message "my first change"
    gs submit
    gs status

Understand the model

Learn the native nouns once the first workflow makes sense.

Read the Git guide

Coming from Git? Start with the translation table.