████████╗███╗   ███╗███████╗
╚══██╔══╝████╗ ████║██╔════╝
   ██║   ██╔████╔██║█████╗
   ██║   ██║╚██╔╝██║██╔══╝
   ██║   ██║ ╚═╝ ██║██║
   ╚═╝   ╚═╝     ╚═╝╚═╝

Declarative Nix Configuration Framework for tmux.

Usage

Run a demo tmux directly from this repo:

nix run

For real use, write a tiny adapter module. Example for hjem — the adapter declares one opaque option, forwards it to tmf.lib.tmuxConfiguration, and puts the resulting package on the user's path:

{ config, lib, pkgs, inputs, ... }:
{
  options.flakeAdapters.tmf = lib.mkOption {
    type = lib.types.deferredModule;
    default = { };
  };

  config.packages = [
    (inputs.tmf.lib.tmuxConfiguration {
      inherit pkgs;
      modules = [ config.flakeAdapters.tmf ];
    }).package
  ];
}

Disclaimer

Personal hobby project, developed in spare time, primarily for my own use. Built with AI assistance. The API surface is unstable and will change without notice — pin a revision if you depend on it. No warranty, no support commitment, no fitness-for-purpose guarantee.