convez.ai
MCP ServerDevOps & InfraestruturaAvançado
pleme-io

Blackmatter Claude

pleme-io/blackmatter-claude

Configuração declarativa e reproducível do Claude Code via Nix/home-manager

Ver no GitHub
InicialPluginScore · de 0 a 100

Mó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-claude

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
25%
Último commit
há 1 dia
Versão
—
Issues abertas
0
Contribuidores
3

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

FileContentMethod
~/.claude/settings.jsonCore settings, permissions, hooks, sandbox, attribution, statuslineDeep-merged
~/.claude/lsp.jsonLSP server configuration (10 languages)Written
~/.claude.jsonMCP servers (user-scope)Deep-merged
~/.claude/skills/Bundled + extra skillsWritten
~/.claude/keybindings.jsonKeyboard shortcutsWritten
~/.claude/agents/Custom subagent definitionsWritten
~/.claude/output-styles/Custom output style definitionsWritten
~/.claude/rules/Instruction rulesWritten
claude-code binaryPackage installationhome.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 at blackmatter.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

GroupDescription
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 config
  • module/statusline.rs -- Rust Nord frost statusline generator
  • skills/ -- bundled Claude Code skills (auto-discovered)

References

Ver o original no GitHub

Bom para

Relacionados