Skip to content

Installation

Requirements

macOS

Download the .dmg from GitHub Releases, open it, and drag Codespace Zed.app to Applications. Then double-click Install CLI.command in the DMG to symlink the codespace-zed CLI into /usr/local/bin.

Available for: aarch64 (Apple Silicon).

Linux

AppImage

Download the .AppImage from GitHub Releases:

chmod +x codespace-zed-*.AppImage
./codespace-zed-*.AppImage

Available for: amd64, arm64.

Tarball

Download the .tar.gz from GitHub Releases. Each tarball includes the binary, an example config, and a systemd user service file.

tar xzf codespace-zed-amd64.tar.gz
sudo cp codespace-zed/codespace-zed /usr/local/bin/
# Optional: install systemd user service
cp codespace-zed/codespace-zed.service ~/.config/systemd/user/
systemctl --user enable --now codespace-zed

Available for: amd64, arm64.

Nix flake

# flake.nix
{
  inputs.codespace-zed.url = "github:linuskendall/zed-spaces-launcher";
}

The package includes shell completions for bash, zsh, and fish.

Home Manager

{
  imports = [ codespace-zed.homeManagerModules.default ];

  programs.codespace-zed = {
    enable = true;
    defaultTarget = "work";
    targets.work = {
      repository = "my-org/my-repo";
      branch = "main";
      machine = "standardLinux32gb";
    };
  };
}

This generates the config file, wraps the binary with --config, sets up SSH includes, installs shell completions, and runs the menu bar applet via launchd (macOS) or systemd (Linux).

From source

go install github.com/ananth/codespace-zed@latest

Requires Go 1.26+ and CGo (for the Fyne GUI toolkit used by the applet).

Verifying releases

All release artifacts are signed with Sigstore cosign (keyless). Each file has a corresponding .sig (signature) and .pem (certificate).

Verify a file

cosign verify-blob \
  --certificate codespace-zed-amd64.tar.gz.pem \
  --signature codespace-zed-amd64.tar.gz.sig \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp 'github.com/linuskendall/zed-spaces-launcher' \
  codespace-zed-amd64.tar.gz

Verify checksums

# Verify the SHA256SUMS file itself was signed by the release workflow
cosign verify-blob \
  --certificate SHA256SUMS.pem \
  --signature SHA256SUMS.sig \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp 'github.com/linuskendall/zed-spaces-launcher' \
  SHA256SUMS

# Then verify file integrity
sha256sum -c SHA256SUMS