Gitslice docs

CLI Reference

A compact lookup for the commands used in normal Gitslice work. Use Start Here for the walkthrough.

Install the gs CLI

The CLI is a single Go binary named gs. Installing it requires Go 1.24 or newer.

Option A — go install (quickest)

go install github.com/gitslice-io/gitslice/cmd/gs@latest

Make sure your Go bin directory is on PATH:

export PATH="$PATH:$(go env GOPATH)/bin"

Option B — build from source

git clone https://github.com/gitslice-io/gitslice.git
cd gitslice
make install   # builds gs (and gitslice-server) into your Go bin

Verify

gs defaults to the hosted endpoint, so you can sign in right away. Point at a different server with --server or GS_SERVER_ADDR.

gs version
gs auth login
gs auth status

Auth

gs auth login: Sign in to an account.
gs auth status: Show the active session.
gs auth logout: Clear local authentication.
gs auth token: Print an auth token for local tooling.

Workspace and source

gs init <account>:<slice>: Create a workspace for one slice.
gs shell: Open the server-backed file shell.
gs status: Show pending workspace edits.
gs diff: Inspect pending content changes.
gs ci: Run the slice's checks against your pending edits, locally.
gs log: Read recent accepted history.
gs show <commit>: Inspect an accepted native commit.

File operations

gs fs ls <path>: List server files.
gs fs cat <path>: Read a server file.
gs fs upload <local> <path>: Upload local content into a pending edit.
gs fs mkdir <path>: Create a directory.

Changesets

gs create --message <title>: Create a changeset from pending edits.
gs modify: Create a new patchset on the active changeset.
gs diff: Review workspace or changeset content.
gs submit: Submit for validation and publish.
gs deps: Inspect dependent changesets.

Slices

gs slice list: List account slices.
gs slice create: Create a slice definition.
gs slice update: Change included paths or policy (e.g. --required-check).
gs slice set-ci-daemon: Designate the daemon that runs out-of-slice checks.
gs slice history: Inspect slice definition versions.

Agents

gs agent start: Run a local agent daemon in an empty directory (codex runtime).
gs agent status: List your agent daemons and whether they are online.
gs agent stop: How to stop a running daemon (Ctrl-C).
gs cs conversation: Show the agent conversation that produced each patchset.