Toolbox

A self-contained, data-driven package registry for turnkey. Version metadata lives in JSON data files — Nix code reads this data to build derivations automatically. Adding a new version means adding a JSON entry, not editing Nix code.

Packages

Toolbox provides versioned, reproducible builds of curated development tools across Linux (x64/arm64) and macOS (x64/arm64), plus toolchain meta-packages that bundle related tools together.

Browse the full package catalog: firefly-engineering.github.io/toolbox

Usage

Standalone

# Build a specific version
nix build .#go.1_26_0

# Build the default version
nix build .#beads.default

# Build a toolchain meta-package
nix build .#rust-toolchain.default

# Run a tool directly
nix run .#jq.default -- --version

With Turnkey

# In turnkey's flake.nix:
inputs.toolbox.url = "github:firefly-engineering/toolbox";

# In registryExtensions:
registryExtensions = {
  go = inputs.toolbox.registry.${system}.go;
  beads = inputs.toolbox.registry.${system}.beads;
};

With home-manager (Claude Code skills)

Skill-bundle packages (e.g. mattpocock-skills) are Claude Code plugin directories, wired into the home-manager claude-code module one of two ways:

# flake input
inputs.toolbox.url = "github:firefly-engineering/toolbox";

# in your home-manager configuration
{ inputs, pkgs, ... }:
let toolbox = inputs.toolbox.packages.${pkgs.system};
in {
  programs.claude-code = {
    enable = true;

    # As a plugin — the bundle's plugin.json drives which skills load:
    plugins = [ toolbox.mattpocock-skills ];

    # …OR as a flat skills directory (mutually exclusive with the plugin above):
    # skills = "${toolbox.mattpocock-skills.skills}";
  };
}

Use one route, not both. The plugins route needs Claude Code ≥ 2.1.76 (≥ 2.1.157 for persistent personal plugins); the skills route has no version floor. Both need a home-manager recent enough to expose programs.claude-code.skills / .plugins. Bundles are filtered to upstream's .claude-plugin/plugin.json, so only the curated skills are installed.

Platforms

All packages target:

• x86_64-linux
• aarch64-linux
• x86_64-darwin
• aarch64-darwin

Adding Packages

See AGENTS.md for the full guide on adding new packages and versions.

License

MIT