stkd
Install stkd

Install

One command. Five package managers.

Same Rust binary on every platform. Pick the ecosystem you already use. 

brew install neul-labs/tap/stkd

macOS · Linux — formula auto-updates on each release.

Prefer pre-built binaries? Grab a release from GitHub Releases. Building from source? See the repository.

  1. 1

    Install the binary

    Pick one of: Homebrew, Cargo, npm, pip, or the one-line curl script. All install the same Rust binary.

  2. 2

    Verify the install

    Run `gt --version` and confirm you see the stkd version (currently 0.1.0).

  3. 3

    Initialize a repo

    In any repo, run `gt repo init`. stkd reads existing Graphite metadata if present; otherwise it starts fresh.

  4. 4

    Authenticate with your provider

    Run `gt auth` for GitHub or `gt auth --gitlab` for GitLab. stkd reuses your existing `gh` or `glab` token.

  5. 5

    Create your first stack

    `gt create feature/your-first-branch`, commit, then `gt create feature/your-second-branch` for the next layer.

Quickstart — your first stack

brew install neul-labs/tap/stkd
cd ~/code/your-repo
gt repo init
gt auth                           # GitHub
# or: gt auth --gitlab            # GitLab

gt create feature/first
# … edit files, then …
git commit -am "first change"

gt create feature/second
git commit -am "second change"

gt log                            # see your stack
gt submit --stack                 # push and open PRs

Install FAQ

Setup questions, answered.

Homebrew on macOS and Linux is the easiest. Cargo gives you the latest crates.io release. npm and pip are convenient if you already manage devtools through them. The curl script handles environments without a package manager.

Ready to stack your next change?

Install stkd in under a minute. Apache-2.0, single binary, every major platform.

Install stkd → Read the docs