AI Tools Flake
clempat/ai-tools-flake
Configuração Nix unificada para Claude, OpenCode e MCP servers
Ver no GitHubFlake Nix unificado para configuração de ferramentas de IA, integrando Claude Code, OpenCode e MCP servers. Automatiza a instalação e configuração via home-manager, incluindo integração com Claude Desktop no macOS e suporte a MCP gateway para servidores HTTP.
Instalação
npx convez-ai clempat/ai-tools-flake1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerenciar múltiplas ferramentas de IA com uma única declaração Nix
- Configurar MCP servers automaticamente para Claude Desktop
- Integrar HTTP MCP servers via mcp-gateway proxy
- Manter consistência de configuração de IA entre sistemas Linux/macOS
Veredito

Solução robusta e declarativa para quem usa NixOS/home-manager e quer gerenciar o ecossistema Claude/OpenCode com reproducibilidade. Reduz fricção operacional significativamente, mas exige familiaridade com Nix e flakes.
README
A tradução para o português deste README ainda está na fila.
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}.commandsoptions - 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
unstablebranch (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:
- The gateway runs as a stdio MCP server (Claude Desktop compatible)
- It proxies requests to your HTTP MCP servers (atlassian, github, context7, etc.)
- 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:
- Open Claude Desktop → Settings → Connectors
- Click "Add custom connector"
- Enter server URLs from
config/mcps.nix - Configure OAuth authentication if needed
Technical Details:
- Gateway uses multi-mcp (Python-based)
- Packaged as a Nix derivation with all dependencies
- Config auto-generated from enabled HTTP servers in
config/mcps.nix
Claude-Flow Commands
Automatically installed workflow commands:
- commit: Create git commits
- create_plan: Generate implementation plans
- create_spec: Create feature specs
- create_ticket: Generate Jira tickets
- create_worktree: Create git worktrees
- implement_plan: Execute implementation plans
- research_codebase: Document codebases
- research_confluence: Research Confluence docs
- validate_plan: Validate implementation plans
Commands automatically configured via:
programs.opencode.commandsprograms.claude-code.commands
Advanced: Direct Package Access
{
# 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
];
}
Advanced: Quick Shell (without home-manager)
nix develop github:clempat/ai-tools-flake
# Provides: opencode, claude-code, agent-browser (Linux), gh
Structure
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
Available Agents
- frontend-developer: Vue.js, TypeScript, modern web dev
- senior-code-reviewer: Code quality, architecture, security
- ui-engineer: UI/UX, accessibility, design systems
- nixos: NixOS configuration with MCP integration
- ticket-driven-developer: Jira ticket-driven dev with spec-kit integration (requires
ghCLI)
Available MCP Servers
- nixos: NixOS packages and options
- figma-desktop: Figma desktop integration
- atlassian: Atlassian/Jira integration
- github: GitHub integration
- brave-search: Brave search
- sentry: Sentry error tracking
- n8n: n8n workflow automation
- todoist: Todoist task management
- playwright: Browser automation
- refs: refs MCP documentation/search
Available Skills
- homeassistant-ai/skills: Imported upstream skill catalog (as non-flake input)
- lint-with-conform: Format files based on conform config
- agent-browser: Browser automation workflows for agent-browser CLI
- excalidraw-diagram: Generate Excalidraw
.excalidrawdiagrams from text specs - gitea-tea: Gitea workflows with tea CLI
- nixos-advisor: NixOS configuration advice
- obsidian-worklog: Obsidian worklog integration
License
MIT