VibeDNA Journal

Um arquivo de diário por projeto que sua IA lê no início da sessão e atualiza enquanto trabalha.

Documentação

VibeDNA Journal MCP

Um arquivo de diário por projeto que sua IA lê no início da sessão e atualiza enquanto trabalha.

O diário dá a cada projeto um arquivo Markdown simples (*_JOURNAL.md). Sua IA o lê quando uma sessão começa e acrescenta a ele conforme o trabalho é entregue: decisões com suas justificativas, bugs com causa raiz e correção, estado atual, roteiro e uma nota de transferência para a próxima sessão. A busca em texto completo ranqueada encontra uma entrada em todos os diários dos projetos de uma só vez. Uma ferramenta opcional adiciona uma regra ao seu CLAUDE.md para que o Claude Code mantenha o hábito sem ser solicitado.

Executa localmente via stdio. Python 3.10+ e o pacote mcp.
O núcleo de registro no diário não faz chamadas de rede. Seus diários permanecem no seu disco.
Ferramentas opcionais de marketplace navegam e baixam diários de vibedna.ai, somente quando você as chama.

Página inicial: https://vibedna.ai/store/journal

Ferramentas (25)

Atualizar-se sobre um projeto

Ferramenta	O que faz
`journal_handoff_brief(name)`	Atualização curta: cabeçalho mais as entradas mais recentes
`journal_read(name, max_kb)`	Conteúdo completo do diário
`journal_read_section(name, section)`	Uma seção, ex.: `Current state` ou `Handoff for next session`
`journal_list_sections(name)`	As seções H2 de um diário
`journal_list(project, last_days)`	Lista os diários no índice

Registrar trabalho conforme é entregue

Ferramenta	O que faz
`journal_append(name, entry, tag)`	Entrada com carimbo de data/hora
`journal_update_section(name, section, new_content, mode)`	Substituir, acrescentar ou antepor uma seção
`journal_create(name, project_dir, body)`	Novo diário com as seções padrão

Busca

Ferramenta	O que faz
`journal_search(query, project)`	Busca em texto completo ranqueada (SQLite FTS5) em todos os diários, com trechos
`journal_recent_changes(last_hours)`	Diários atualizados recentemente
`journal_stats()`	Totais, maiores e mais recentes diários
`journal_browse(domain, tier, kind, tag)`	Navegar pela biblioteca local por metadados
`journal_market_index(kind)`	Feed local de diários de um tipo, com metadados
`journal_overlap_check(name)`	Encontrar diários que se sobrepõem a este

Configuração

Ferramenta	O que faz
`journal_index_refresh()`	Reescaneia as raízes em busca de arquivos de diário
`journal_config_add_root(path)`	Adiciona uma pasta para escanear
`journal_get_claude_rule()`	O texto de regra `CLAUDE.md` recomendado
`journal_install_rule(scope, confirm)`	Instala essa regra (pré-visualização, a menos que `confirm=True`)
`journal_backup_to_drive(name, remote, remote_folder)`	Copia diários para seu próprio remoto rclone (opcional)
`check_for_update()`	Compara esta cópia com a versão publicada
`vibedna_info()`	Metadados do produto

Marketplace (opcional, acessa vibedna.ai)

Ferramenta	O que faz
`journal_market(query, domain)`	Navega pela prateleira de diários do VibeDNA
`journal_pair(token)`	Vincula esta instalação a uma conta vibedna.ai
`journal_get(slug)`	Baixa um diário que você possui, ou obtém um link de checkout para um que não possui
`journal_library()`	Lista os diários que você possui

Instalação

git clone https://github.com/marstudio360/vibedna-journal-mcp
cd vibedna-journal-mcp
pip install -r requirements.txt

JOURNAL_ROOTS é a lista de pastas para escanear em busca de arquivos de diário, separadas por ;. Sem isso, o Journal escaneia ~/Desktop e ~/Documents.

Claude Code

claude mcp add journal --scope user -e JOURNAL_ROOTS="/path/to/your/projects" -- python /absolute/path/to/vibedna-journal-mcp/server.py

Ou no .mcp.json de um projeto:

{
  "mcpServers": {
    "journal": {
      "command": "python",
      "args": ["/absolute/path/to/vibedna-journal-mcp/server.py"],
      "env": { "JOURNAL_ROOTS": "/path/to/your/projects" }
    }
  }
}

Então peça ao Claude: "Instale a regra do CLAUDE.md do diário globalmente." Esse é o passo que faz com que ele leia e escreva os diários por conta própria.

Cursor

Adicione o mesmo bloco mcpServers ao ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto).

Claude Desktop

Adicione o mesmo bloco mcpServers ao claude_desktop_config.json (Configurações > Desenvolvedor > Editar Configuração) e reinicie o Claude Desktop.

INSTALL.md é um guia passo a passo escrito para que você possa colá-lo em um chat de IA e deixar a IA fazer a instalação.

Configuração

Variável	Padrão	O que faz
`JOURNAL_ROOTS`	`~/Desktop;~/Documents`	Pastas para escanear em busca de arquivos `JOURNAL.md`
`JOURNAL_HOME`	`~/.journal`	Onde o índice de busca e a configuração opcional ficam
`JOURNAL_TRANSPORT`	`stdio`	`http` serve HTTP transmitível em `PORT`, somente para hospedagem em nuvem

Estrutura do diário

journal_create inicia cada diário com estas seções:

## Vision / Why this exists
## Current state
## Roadmap
## Decisions log
## Incidents
## Handoff for next session
## Recent entries

Segurança

Veja SECURITY.md para saber o que o servidor lê, escreve e envia.

Licença

Suporte: admin@vibedna.ai