Nix

Requires Nix with flakes enabled.

Quick start

Run workmux without installing:

nix run github:raine/workmux -- --help

Flake input

inputs.workmux.url = "github:raine/workmux";

Installation

Home Manager

Install the package and write the config file directly:

{ inputs, pkgs, ... }:

{
  home.packages = [ inputs.workmux.packages.${pkgs.system}.default ];

  xdg.configFile."workmux/config.yaml".text = ''
    merge_strategy: rebase
    agent: claude
    panes:
      - command: <agent>
        focus: true
      - split: horizontal
  '';
}

See Configuration for all config options.

NixOS

{ inputs, pkgs, ... }:

{
  environment.systemPackages = [
    inputs.workmux.packages.${pkgs.system}.default
  ];
}

Shell completions

The flake automatically installs completions for Bash, Zsh, and Fish. Do not add the manual eval "$(workmux completions ...)" lines from the Installation guide.