Blackmatter Claude
pleme-io/blackmatter-claude
Configuração declarativa e reproducível do Claude Code via Nix/home-manager
Ver no GitHubMódulo declarativo para home-manager que gerencia a configuração completa do Claude Code, incluindo LSP servers, MCP servers, skills, keybindings e regras de segurança. Integra sandbox, permissões, hooks de lifecycle e múltiplas linguagens via Nix puro.
Instalação
npx convez-ai pleme-io/blackmatter-claude1 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 extensões e plugins do Claude Code de forma versionada
- Configurar LSP servers para 10+ linguagens de programação
- Ativar e configurar MCP servers (GitHub, Kubernetes, etc) com segurança
- Definir regras de permissão, sandbox e lifecycle hooks para tools
Veredito

Solução robusta e bem estruturada para quem usa NixOS/home-manager e quer versionamento declarativo do ambiente Claude. Requer familiaridade com Nix e é ideal para equipes que precisam de configurações reproducíveis e auditáveis. Suporte a deep-merge preserva edições manuais sem conflitos.
README
A tradução para o português deste README ainda está na fila.
blackmatter-claude
Full declarative Claude Code configuration via home-manager.
What it manages
| File | Content | Method |
|---|---|---|
~/.claude/settings.json | Core settings, permissions, hooks, sandbox, attribution, statusline | Deep-merged |
~/.claude/lsp.json | LSP server configuration (10 languages) | Written |
~/.claude.json | MCP servers (user-scope) | Deep-merged |
~/.claude/skills/ | Bundled + extra skills | Written |
~/.claude/keybindings.json | Keyboard shortcuts | Written |
~/.claude/agents/ | Custom subagent definitions | Written |
~/.claude/output-styles/ | Custom output style definitions | Written |
~/.claude/rules/ | Instruction rules | Written |
| claude-code binary | Package installation | home.packages |
Deep-merged files use a Rust activation script that preserves manual edits, removes stale nix store paths, and validates MCP server binaries.
Flake outputs
homeManagerModules.default-- home-manager module atblackmatter.components.claude
Quick start
{
inputs.blackmatter-claude.url = "github:pleme-io/blackmatter-claude";
}
blackmatter.components.claude = {
enable = true;
# Model and behavior. Fleet doctrine ("intelligence over speed") flows
# from `anvil.doctrine.intelligenceOverSpeed` via
# `anvil.translatedSettings.claude`, applied here as mkDefault — so
# effortLevel resolves to "max", alwaysThinkingEnabled to true, and
# fastModePerSessionOptIn to true in the fleet without restating
# them. This module assumes blackmatter-anvil is also imported. To
# change the fleet-wide value, edit anvil.doctrine.*.
settings = {
model = "opus";
# effortLevel = "max"; # from anvil doctrine
# alwaysThinkingEnabled = true; # from anvil doctrine
# fastModePerSessionOptIn = true; # from anvil doctrine
autoMemoryEnabled = true;
env.ANTHROPIC_MODEL = "opus";
};
# Permission rules
permissions = {
defaultMode = "default";
allow = [ "Bash(npm run *)" "mcp__github__*" ];
deny = [ "Read(./.env)" ];
};
# Sandbox
sandbox = {
enabled = true;
filesystem.denyRead = [ "~/.ssh" "~/.gnupg" ];
network.allowedDomains = [ "api.github.com" ];
};
# Lifecycle hooks
hooks.PreToolUse = [{
matcher = "Bash";
hooks = [{ type = "command"; command = "/path/to/validate.sh"; }];
}];
# LSP servers (all enabled by default)
lsp.nix.enable = true;
lsp.rust.enable = true;
# MCP servers
mcp.github.enable = true;
mcp.kubernetes.enable = true;
# MCP packages on PATH
mcpPackages.enable = true;
};
Option groups
| Group | Description |
|---|---|
settings.* | Core settings: model, effort, language, UI, auth, env vars |
permissions.* | Tool allow/deny/ask rules, default mode |
attribution.* | Git commit/PR attribution text |
sandbox.* | Filesystem and network sandboxing |
hooks.* | Lifecycle event hooks (PreToolUse, Stop, etc.) |
keybindings.* | Custom keyboard shortcuts |
agents.* | Custom subagent definitions |
outputStyles.* | Custom output style definitions |
rules.* | Instruction rules (path-scoped or unconditional) |
lsp.* | Language server configuration (10 languages + extra) |
mcp.* | MCP server configuration (9 servers + extra) |
skills.* | Bundled + extra skills |
theme.* | Statusline theming |
mcpPackages.* | MCP server packages installed to PATH (30+) |
LSP servers
nixd, rust-analyzer, typescript-language-server, basedpyright, gopls, lua-language-server, bash-language-server, zls, ruby-lsp, clangd
MCP servers
zoekt, codesearch, github, kubernetes, fluxcd, chrome-devtools, curupira, umbra, typemill
Structure
module/-- home-manager module (options + config)module/claude-config-merge.rs-- Rust deep-merge tool for JSON configmodule/statusline.rs-- Rust Nord frost statusline generatorskills/-- bundled Claude Code skills (auto-discovered)