Install¶

adept is a single self-contained binary. Pick whichever channel fits your platform.

Go¶

go install github.com/itaywol/adeptability/cmd/adept@latest

Requires Go 1.25+. Installs to $(go env GOBIN) (or $(go env GOPATH)/bin) — make sure it's on your PATH.

Homebrew (macOS / Linux)¶

brew install itaywol/tap/adeptability

curl installer¶

curl -fsSL https://raw.githubusercontent.com/itaywol/adeptability/main/scripts/install.sh | sh

The installer downloads the latest release archive, verifies its cosign signature, and drops the binary in /usr/local/bin. Environment overrides:

Variable	Default	Purpose
`ADEPT_VERSION`	`latest`	Install a specific release tag
`ADEPT_BIN_DIR`	`/usr/local/bin`	Install location
`ADEPT_NO_VERIFY`	`0`	Set to `1` to skip cosign verification

Nix / NixOS (flake)¶

The repo ships a flake exposing the package, an overlay, and a dev shell.

# try it without installing
nix run github:itaywol/adeptability -- --help

# imperative install into your profile
nix profile install github:itaywol/adeptability

Declarative NixOS / home-manager setup — add the input and pull the package:

{
  inputs.adeptability.url = "github:itaywol/adeptability";

  # NixOS:          environment.systemPackages = [ inputs.adeptability.packages.${pkgs.system}.default ];
  # home-manager:   home.packages             = [ inputs.adeptability.packages.${pkgs.system}.default ];
  # or apply the overlay and use pkgs.adeptability:
  #   nixpkgs.overlays = [ inputs.adeptability.overlays.default ];
}

Pin a release with github:itaywol/adeptability/v1.6.0. nix develop drops you into a shell with go, gopls, and golangci-lint for hacking on adept itself.

Docker (GHCR)¶

docker run --rm -v "$PWD:/work" -w /work ghcr.io/itaywol/adeptability:latest --help

Mount your project at /work so adept operates on your repo.

Pre-built binaries¶

Every release ships cross-compiled archives for darwin / linux / windows × amd64 / arm64, plus checksums.txt, cosign signatures, and build-provenance attestation. Download from the latest release.

Other package managers

Scoop, WinGet, and an npm wrapper are prototyped but not published yet. If you want one of them, add a 👍 to the additional package managers issue so we know it's worth committing to maintaining.

Verify the install¶

adept --version
adept --help

Shell completion¶

adept ships cobra completion for bash, zsh, and fish:

adept completion zsh > "${fpath[1]}/_adept"   # zsh
adept completion bash > /etc/bash_completion.d/adept
adept completion fish > ~/.config/fish/completions/adept.fish