AI Tools Flake

Unified Nix flake for AI tools configuration including Claude Code, OpenCode, MCP servers, and AI agents.

Features

• Unified Module: Single home-manager module that configures both Claude Code and OpenCode
• MCP Servers: Shared MCP server configurations across tools
• Claude Desktop Integration: Auto-configures MCP servers for Claude Desktop on macOS
• AI Agents: Reusable agent definitions with tool-specific metadata
• Claude Skills: Pre-configured skills for various tasks
• Claude-Flow Commands: Uses upstream programs.{opencode,claude-code}.commands options
• Packages: Custom packages like spec-kit
• Default Configurations: Sensible defaults that can be overridden per-system
• Flexible Versioning: Control opencode/claude-code versions via flake follows or nixpkgs overlays

Requirements

• home-manager: Must use unstable branch (programs.claude-code only in unstable)
• nixpkgs: Recommends nixos-unstable (claude-code package)

Usage

As a Flake Input

Add to your flake.nix:

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
    home-manager.url = "github:nix-community/home-manager";
    home-manager.inputs.nixpkgs.follows = "nixpkgs";
    
    ai-tools.url = "github:clempat/ai-tools-flake";
    ai-tools.inputs.nixpkgs.follows = "nixpkgs";  # Use your nixpkgs
  };

  outputs = { nixpkgs, home-manager, ai-tools, ... }: {
    homeConfigurations.youruser = home-manager.lib.homeManagerConfiguration {
      pkgs = nixpkgs.legacyPackages.x86_64-linux;
      modules = [
        ai-tools.nixosModules.default
        {
          programs.ai-tools.enable = true;
        }
      ];
    };
  };
}

Home Manager Integration

Basic Setup (Minimal)

{ inputs, ... }:
{
  imports = [ inputs.ai-tools.nixosModules.default ];

  programs.ai-tools.enable = true;
  
  # That's it! Automatically:
  # - Installs claude-code & opencode from nixpkgs-unstable
  # - Configures MCPs, agents, memory from config/
  # - Adds claude-flow commands
  # - Auto-configures Claude Desktop (macOS)
}

Override Package Versions

The module automatically uses packages from the flake. To override:

{ inputs, pkgs, ... }:
{
  imports = [ inputs.ai-tools.nixosModules.default ];

  programs.ai-tools.enable = true;
  
  # Optional: override package versions
  programs.opencode.package = inputs.opencode.packages.${pkgs.system}.default;
  programs.claude-code.package = pkgs.unstable.claude-code;
}

Claude Desktop Configuration (macOS)

On macOS, the module automatically configures Claude Desktop by generating ~/Library/Application Support/Claude/claude_desktop_config.json.

What's Auto-Configured:

• ✅ stdio MCP servers (nixos, playwright) are automatically added to the config file
• ✅ HTTP MCP servers via the mcp-gateway proxy (NEW!)

MCP Gateway (Automatic HTTP Support)

The flake includes an mcp-gateway package that acts as a stdio→HTTP proxy, allowing ALL your HTTP MCP servers to work with Claude Desktop automatically!

How it works:

1. The gateway runs as a stdio MCP server (Claude Desktop compatible)
2. It proxies requests to your HTTP MCP servers (atlassian, github, context7, etc.)
3. All HTTP servers appear as tools in Claude Desktop

Generated config:

{
  "mcpServers": {
    "gateway": {
      "command": "/nix/store/.../bin/mcp-gateway",
      "env": {
        "MCP_GATEWAY_CONFIG": "~/.config/mcp-gateway/config.json"
      }
    },
    "nixos": {
      "command": "nix",
      "args": ["run", "github:utensils/mcp-nixos", "--"]
    }
  }
}

The gateway config (~/.config/mcp-gateway/config.json) is automatically generated from your config/mcps.nix HTTP servers.

Alternative: Manual Configuration

If you prefer manual configuration or the gateway doesn't work:

1. Open Claude Desktop → Settings → Connectors
2. Click "Add custom connector"
3. Enter server URLs f

... View full README on GitHub