Claude Code Boss
AllanSantos-DV/claude-code-plugins
Base de conhecimento semântica + aprendizado in-loop para Claude Code
Ver no GitHubMonorepo de plugins para Claude Code Desktop com Brain KB (base de conhecimento local com busca semântica), aprendizado in-loop, indexação de memória nativa e execução curada via MCP server. Oferece 7 tools MCP para recuperação híbrida com rerank por decay, captura automática de lições com admission control e dashboard local para gerenciamento.
Instalação
npx convez-ai AllanSantos-DV/claude-code-plugins1 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
- Manter base de conhecimento persistente entre sessões de codificação
- Recuperar outputs relevantes via busca semântica com rerank inteligente
- Capturar e consolidar lições aprendidas automaticamente no loop
- Indexar e buscar across projects na Auto Memory nativa do Claude Code
Veredito

Plugin maduro e bem arquitetado para quem quer memória semântica persistente além da Auto Memory nativa. Carga cognitiva alta: requer Node.js, configuração de embeddings (Transformers.js/Ollama/Voyage) e compreensão de MCP servers. Executores sérios de workflows repetitivos ganham muito.
README
A tradução para o português deste README ainda está na fila.
Claude Code Plugins
Monorepo de plugins para Claude Code Desktop — desenvolvido por Allan Santos.
Plugins
| Plugin | Versão | Descrição |
|---|---|---|
| claude-code-boss | 1.10.0 | Brain KB (busca semântica), execução curada (anti context-bloat) e aprendizado in-loop para Claude Code |
O que é o claude-code-boss?
Plugin para Claude Code Desktop focado no que o nativo não entrega. A orquestração fica a cargo das ferramentas nativas (Agent/Workflow) — após o slim-down de 2026-05 a camada própria de orquestração foi removida.
O que está entregue:
- Brain KB — base de conhecimento local (SQLite + embeddings via Transformers.js/Ollama/Voyage), indexação automática de outputs relevantes, recuperação híbrida (vetor + keyword) com rerank por decay (relevância + recência + frequência + confiança), grafos de citação, servidor MCP com 7 tools — KB:
brain_search,brain_store,brain_related,brain_count,capture_lesson; Web research:research_query,research_status - Aprendizado in-loop — tool MCP
capture_lessonpara captura curada de lições no loop (sem reler transcript), com admission control (A-MAC) que mescla duplicatas e incrementarecurrence. Promoção curada de lições recorrentes a skills viabrain-promote.js - Native Memory Indexing —
brain-index-native.jsindexa a Auto Memory nativa (~/.claude/projects/<cwd>/memory/*.md) no Brain para busca semântica e cross-project que a camada nativa não oferece - Hooks pipeline (advisory) — 5 eventos (SessionStart, PreToolUse, PostToolUse, Stop, UserPromptSubmit), ~9 scripts. Tom informativo, não coercitivo, com backpressure (cooldown + cap de contagem) para evitar context bloat
- Execução curada (Shell Workbench) —
curation-guardbloqueia/redireciona comandos curados;curation-detectdetecta outputs grandes;session-whitelistpopula ecossistema no boot - Dashboard local — servidor HTTP em
localhost(porta dinâmica, token auth), 4 abas: Home, Brain KB, Hooks, Logs. Lançado sob demanda (não auto-inicia mais no SessionStart). Ring buffer de 500 entradas + agregação de erros via.runtime/hook-errors.jsonl - Subagentes —
brain-indexer(haiku, pinned). Captura de lições/consolidação/refine/curation rodam in-loop via tool MCPcapture_lessone hooks Stop (pattern-detect/curation-stop/refine-research), sem subagentes dedicados
Estrutura
claude-code-plugins/
├── claude-code-boss/ # Plugin principal
│ ├── .claude-plugin/ # Manifesto do plugin (plugin.json)
│ ├── .mcp.json # Servidor MCP: brain-server
│ ├── agents/ # subagentes (.agent.md)
│ ├── config/ # brain-config.json, hooks-config.json
│ ├── dashboard/ # index.html — SPA (4 abas)
│ ├── docs/ # Guias de upgrade (Ollama, Voyage, MCP Memory)
│ ├── hooks/ # hooks.json (5 eventos, ~9 scripts)
│ ├── scripts/ # Scripts Node.js (hooks + CLI + Brain + Dashboard)
│ ├── servers/brain-server/ # MCP server (Node.js ESM)
│ ├── skills/ # 5 skills do Claude Code
│ ├── package.json # npm test, version:sync
│ └── CHANGELOG.md # Notas de release
└── .github/workflows/ci.yml # CI: test + lint + grep anti-patterns + version sync
Instalação
Requer Claude Code Desktop. Consulte docs.anthropic.com/en/docs/claude-code para detalhes sobre a plataforma.
Node.js 22.13+ precisa estar no
PATHdo sistema. O Claude Code dispara os hooks e o servidor MCP comnodepuro do PATH do sistema, não pelo Node embutido no Desktop (claude-code#66183). Sem Node no PATH, os hooks viram no-op e o Brain MCP fica DOWN (spawn node ENOENT). No Windows: instale o MSI oficial e reabra o Claude Code por completo (tray + Gerenciador de Tarefas).
# 1. Clone o repositório
git clone https://github.com/AllanSantos-DV/claude-code-plugins.git
cd claude-code-plugins/claude-code-boss
# 2. Instale dependências Node.js
npm install
# 3. Registre o plugin no Claude Code Desktop
# No Claude Code, abra Settings → Plugins → Add local plugin
# Aponte para: <caminho-do-repo>/claude-code-boss/.claude-plugin/plugin.json
# 4. Configure a variável de ambiente (necessária para os hooks)
# No seu ~/.bashrc / ~/.zshrc / ~/.profile:
export CLAUDE_PLUGIN_ROOT="<caminho-do-repo>/claude-code-boss"
Veja claude-code-boss/README.md para configuração detalhada, providers de embedding, e guias de upgrade.