Nix packages for AI coding agents and development tools. Automatically updated daily.

Add to your system configuration:

{
  inputs = {
    llm-agents.url = "github:numtide/llm-agents.nix";
  };

  # In your system packages:
  environment.systemPackages = with inputs.llm-agents.packages.${pkgs.stdenv.hostPlatform.system}; [
    claude-code
    opencode
    gemini-cli
    qwen-code
    # ... other tools
  ];
}

Alternatively, use the overlay to access packages under the llm-agents namespace:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
    llm-agents.url = "github:numtide/llm-agents.nix";
  };

  outputs = { nixpkgs, llm-agents, ... }: {
    # NixOS / nix-darwin configuration
    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [{
        nixpkgs.overlays = [ llm-agents.overlays.default ];
        environment.systemPackages = [
          pkgs.llm-agents.claude-code
          pkgs.llm-agents.codex
          pkgs.llm-agents.gemini-cli
        ];
      }];
    };
  };
}

Browse all available tools with the interactive launcher:

nix run github:numtide/llm-agents.nix

This opens an fzf picker listing every package with its description. Select one and it will be run via nix run.

Or run a specific tool directly:

nix run github:numtide/llm-agents.nix#claude-code
nix run github:numtide/llm-agents.nix#opencode
nix run github:numtide/llm-agents.nix#gemini-cli
nix run github:numtide/llm-agents.nix#qwen-code
# etc...

Pre-built binaries are available from the Numtide binary cache. All packages are built daily via CI and pushed to the cache, so you can avoid compiling from source.

This cache is automatically configured when this flake is used directly (e.g nix run github:numtide/llm-agents.nix#claude-code)

To use the binary cache when using this flake as an input, add nixConfig to your flake:

{
  nixConfig = {
    extra-substituters = [ "https://cache.numtide.com" ];
    extra-trusted-public-keys = [ "niks3.numtide.com-1:DTx8wZduET09hRmMtKdQDxNNthLQETkc/yaX7M4qK0g=" ];
  };
}

Alternatively, you can configure this system-wide in your NixOS configuration:

nix.settings = {
  extra-substituters = [ "https://cache.numtide.com" ];
  extra-trusted-public-keys = [
    "niks3.numtide.com-1:DTx8wZduET09hRmMtKdQDxNNthLQETkc/yaX7M4qK0g="
  ];
};

nix develop

# Build a specific package
nix build .#claude-code
nix build .#opencode
nix build .#qwen-code
# etc...

# Format all code
nix fmt

# Run checks
nix flake check

All packages support:

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

This repository serves as a laboratory for exploring how Nix can enhance AI-powered development:

• Sandboxed execution: claudebox demonstrates transparent, sandboxed AI agent execution
• Provider abstraction: claude-code-router explores decoupling AI interfaces from specific providers
• Tool composition: Investigating how multiple AI agents can work together in Nix environments

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Run nix fmt before committing
4. Submit a pull request

• natsukium/mcp-servers-nix - Nix packages for MCP (Model Context Protocol) servers
• aaddrick/claude-desktop-debian - Claude Desktop for Linux

Individual tools are licensed under their respective licenses.

The Nix packaging code in this repository is licensed under MIT.