AI Tools Flake

AI工具缺陷

用于AI工具配置的统一Nix-flake，包括Claude Code、OpenCode、MCP服务器和AI代理。

特性

• 统一模块：配置Claude Code和OpenCode的单个家庭管理器模块
• MCP服务器：跨工具共享MCP服务器配置
• Claude桌面集成：在macOS上为Claude Desktop自动配置MCP服务器
• AI代理：具有工具特定元数据的可重用代理定义
• 克劳德技能：各种任务的预配置技能
• Claude Flow命令：上游用途 programs.{opencode,claude-code}.commands 选项
• 包裹：定制包，如spec kit
• 默认配置：每个系统都可以覆盖的合理默认值
• 灵活的版本控制：通过flake follow或nixpkgs overlay控制opencode/claude代码版本

需求

• 家庭经理：必须使用 unstable 分支（programs.claude-code仅在不稳定的情况下）
• nixpkgs：建议 nixos-unstable （克劳德代码包）

用法

作为襟翼输入

添加到您的 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集成

基本设置（最小）

{ 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)
}

覆盖包版本

该模块会自动使用薄片中的包。要覆盖，请执行以下操作：

{ 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桌面配置（macOS）

在macOS上，该模块通过生成以下内容自动配置Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json.

什么是自动配置：

• ✅ stdio MCP服务器 （nixos，剧作家）会自动添加到配置文件中
• ✅ HTTP MCP服务器 通过 mcp网关 代理（新！）

MCP网关（自动HTTP支持）

薄片包括 mcp-gateway 充当stdio的包→HTTP代理，允许您的所有HTTP MCP服务器自动与Claude Desktop配合使用！

它是如何工作的：

1. 网关作为stdio MCP服务器运行（兼容Claude Desktop）
2. 它将请求代理到您的HTTP MCP服务器（atlasian、github、context7等）
3. 所有HTTP服务器都显示为Claude Desktop中的工具

生成的配置：

{
  "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", "--"]
    }
  }
}

网关配置(~/.config/mcp-gateway/config.json)由您的 config/mcps.nix HTTP服务器。

替代方案：手动配置

如果您更喜欢手动配置或网关不工作：

1. 打开克劳德桌面→ 设置→ 连接器
2. 点击 “添加自定义连接器”
3. 输入来自的服务器URL config/mcps.nix
4. 如果需要，配置OAuth身份验证

技术细节：

• Gateway使用 多mcp （基于Python）
• 打包为具有所有依赖项的Nix派生
• 从中启用的HTTP服务器自动生成的配置 config/mcps.nix

Claude Flow命令

自动安装的工作流命令：

• 承诺：创建git提交
• 创建计划：制定实施计划
• create_spec：创建功能规格
• 创建_票：生成Jira票证
• 创建工作树：创建git工作树
• 实施计划：执行实施计划
• 研究_贬值：文档代码库
• 研究影响：研究汇流文档
• validate_plan：验证实施计划

通过以下方式自动配置命令：

• programs.opencode.commands
• programs.claude-code.commands

高级：直接包访问

{
  # Access packages from the flake directly
  home.packages = [
    inputs.ai-tools.packages.${system}.opencode
    inputs.ai-tools.packages.${system}.claude-code
    inputs.ai-tools.packages.${system}.spec-kit
  ];
}

高级：快速外壳（不带家庭管理器）

nix develop github:clempat/ai-tools-flake
# Provides: opencode, claude-code, agent-browser (Linux), gh

结构

ai-tools-flake/
├── flake.nix              # Main flake definition
├── modules/
│   └── ai-tools.nix       # Home-manager module
├── config/                # All configuration
│   ├── agents.nix         # Default agent configurations
│   ├── mcps.nix           # Default MCP server configurations
│   ├── memory.md          # Default memory/rules
│   ├── agents/            # Agent content markdown files
│   └── skills/            # Claude skills (plus pinned external inputs)
│       ├── agent-browser/
│       ├── gitea-tea/
│       ├── lint-with-conform/
│       ├── nixos-advisor/
│       └── nixos-command-not-found/
├── commands/              # Claude-flow workflow commands
│   ├── commit.md
│   ├── create_plan.md
│   ├── create_spec.md
│   ├── create_ticket.md
│   ├── create_worktree.md
│   ├── implement_plan.md
│   ├── research_codebase.md
│   ├── research_confluence.md
│   └── validate_plan.md
├── pkgs/
│   └── spec-kit.nix       # Spec-kit package
└── overlays/
    └── default.nix        # OpenCode wrapper overlay

可用代理

• 前端开发人员：Vue.js、TypeScript、现代web开发
• 高级代码审查员：代码质量、架构、安全
• ui工程师：用户界面/用户体验、可访问性、设计系统
• 尼克斯：NixOS配置，集成MCP
• 票驱动开发人员：Jira票证驱动的开发，带有spec工具包集成（需要 gh CLI）

可用的MCP服务器

• 尼克斯：NixOS软件包和选项
• figma桌面：Figma桌面集成
• 阿特拉斯：Atlassian/Jira集成
• GitHub：GitHub集成
• 勇敢的搜寻：勇敢的搜索
• 哨兵：哨兵错误跟踪
• n8n：n8n工作流自动化
• 任务管理：Todoist任务管理
• 剧作家：浏览器自动化
• 参考文献：参考MCP文档/搜索

可用技能

• 家庭助理人工智能/技能：导入上游技能目录（作为非片状输入）
• 符合要求的棉绒：根据符合配置格式化文件
• 代理浏览器：代理浏览器CLI的浏览器自动化工作流
• 析图：生成Excalidraw .excalidraw 文本规范中的图表
• 吉塔茶：使用tea CLI的Gitea工作流
• nixos顾问：NixOS配置建议
• 黑曜岩工作日志：黑曜石工作日志集成

许可证

麻省理工学院