Funcionalidades

Tudo que o Hero MCP faz pelo seu agente

Memória semântica, código indexado, documentação, mapa do projeto e workflow MCP — catálogo completo das tools e comandos disponíveis no editor.

Voltar ao início
Memória

Contexto persistente entre sessões

Salvar memórias
memory_save

Registre fatos, preferências, decisões e snippets com tags, projeto e visibilidade — o agente classifica automaticamente.

Busca em camadas
hero_search

Primeiro uma lista curta — título, resumo e quantos tokens custa cada resultado; depois o agente abre só o que interessa, vários de uma vez. Menos contexto gasto em cada busca.

Pacote de contexto
memory_context

Carrega as memórias mais relevantes de uma vez — ideal no início da sessão ou antes de uma tarefa grande.

Sugestão ao encerrar
memory_suggest

No fim da sessão, o agente propõe o que vale persistir — você só confirma antes de perder o contexto do chat.

Limpeza inteligente
memory_clean

Sugestões read-only de memórias obsoletas ou duplicadas antes de arquivar — mantém o banco enxuto.

Visibilidade granular
private · team · tenant

Privado por padrão; compartilhe com um time ou toda a organização quando fizer sentido.

Linha do tempo
hero_search around

A partir de uma memória, veja o que foi registrado antes e depois no mesmo projeto — o contexto da decisão, em ordem.

Aviso de código alterado
possiblyStale

Quando um merge altera um arquivo citado numa memória, ela é marcada como possivelmente desatualizada, com os arquivos — até ser atualizada.

Trechos privados
<private>

Envolva em <private>…</private> o que não deve ser guardado; segredos no texto são mascarados automaticamente.

Código

Repositório pesquisável por significado

Indexação de código
scripts/index-code.mjs

Envie o código-fonte para busca semântica (RAG). Workflow GitHub Actions via scripts/index-code.mjs — vem no /hero_initialize.

Busca cross-project
memory_search

Encontre memórias e trechos de código indexados de qualquer projeto da organização — sem trocar de repositório.

Integrações entre projetos
capability_lookup

Verifique se outro projeto já expõe a API, webhook ou contrato que você precisa — com datas de atualização e alertas de staleness.

Documentação

Docs gerados do código e das memórias

Geração de documentação
docs_generate

Overview, arquitetura, APIs, modelos de dados e diagramas Mermaid — a partir do código indexado, memórias e mapa. Determinístico ou aprimorado com IA (Bedrock).

Acompanhar geração
docs_get

Poll assíncrono por docId até o markdown ficar pronto — com data de geração e rodapé de auditoria.

Mapa

Grafo causal do projeto

Visualizar mapa
map_get

Nós de decisões, milestones e mudanças com relações entre si — contexto estruturado além das memórias lineares.

Atualizar mapa
map_patch

Adicione nós e arestas após decisões ou mudanças de plano — vincule memoryId para rastrear a origem.

Knowledge graph da arquitetura

Construir o grafo
graph_patch

O agente analisa o código e monta o grafo tipado: nós com camada e complexidade, arestas com peso, tour guiado e domínios de negócio.

Impacto de mudanças
diff_impact

Cruza os arquivos do git diff com o grafo: nós alterados, vizinhos impactados, arestas entre camadas e risco — com overlay visual em /graph.

Caminho de dependências
graph_path

Menor caminho entre dois nós do grafo — "como X chega em Y?" — animado no canvas e disponível como tool.

Viewer público
/graph-viewer

Exporte o grafo em JSON, commite no repositório e compartilhe: qualquer pessoa visualiza sem login e sem API key.

Exportar para draw.io
.drawio

Baixe o knowledge graph, o mapa do projeto, o grafo de memórias ou os diagramas Mermaid dos docs como um .drawio editável — layout em camadas já resolvido, várias páginas num arquivo só, pronto pro diagrams.net.

Specs

Specs: do pedido ao contrato verificado

Explorar o contexto
spec_explore

Memórias, mapa, specs e mudanças ativas sobre um tema num só lugar, antes de propor qualquer coisa.

Propor uma mudança
spec_propose

Proposta, tarefas e deltas de requisitos com cenários GIVEN/WHEN/THEN — validados e versionados no Hero.

Executar tarefas
spec_apply

Progresso por tarefa salvo na mudança; outra sessão ou outro dev continua de onde parou.

Verificar com cache
spec_verify

Checklist de requisitos conferido pelo agente; o resultado fica em cache pelo hash dos deltas + commit.

Arquivar como spec
spec_archive

Aplica os deltas na spec da capability numa transação e marca a mudança como concluída no mapa.

Workflow MCP

Setup e comandos no editor

Initialize completo
heromcp_initialize

Um comando carrega memórias, grava RULE, todos os /hero_* e o workflow de indexação — idempotente a cada sessão.

Rules sync
memory_rules

A RULE ensina o agente a usar o Hero MCP; o sync CLI puxa preferências e decisões do banco para o repositório.

Auditoria de estado
sync_all

Revise memórias, mapa e lacunas antes de encerrar — garante que nada importante ficou de fora.

Comandos /hero_*
/hero_*

Atalhos no Cursor para cada tool MCP — initialize, save, search, map, docs e mais, sem decorar nomes de API.

Início e fim de sessão automáticos
scripts/hero-hook.mjs

Funciona no Claude Code, no Cursor e no VS Code (Copilot): o /hero_initialize pergunta qual IDE você usa (uma, algumas ou todas) e instala os hooks dela. Ao abrir a sessão o contexto do projeto já chega ao agente; ao encerrar, se houve edição sem registro, ele é lembrado de salvar (uma vez). HERO_HOOKS=off desliga.

Organização

Multi-tenant e automação

Multi-organização
tenant switcher

Um usuário pode pertencer a várias orgs; o switcher troca o tenant ativo sem desconectar o MCP.

Projetos ilimitados
proj:<id>

Cada repositório ou pasta vira um projeto (tag proj:id). Planos pagos: projetos sem limite por organização.

OAuth para CI
OAuth clients

Clientes OAuth para IDEs e GitHub Actions — indexação de código sem API key fixa no repositório.

Memórias persistentes para agentes de IA — isoladas por organização e prontas para o seu time.