logo
0
0
WeChat Login
crispyberry<ssslvky@gmail.com>
chore: pics in readme

MemoV - A Camada de Memória para Agentes de Codificação IA

English | Deutsch | Español | Français | 日本語 | 한국어 | Português | Русский | 中文

VibeGit🤌: Rastreamento automático de prompts, contexto e diffs de código

License: MIT Discord DeepWiki Twitter Follow

MemoV é uma camada de memória para agentes de codificação IA que fornece controle de versão rastreável e baseado em Git para prompts, contexto e diffs de código. Habilita VibeGit - versionamento automático de sessões de codificação IA com exploração de branches, capacidades de rollback e zero poluição do repositório .git padrão.

MemoVCheckpoints
Exploração de branchesLinha temporal linear
Entre sessõesLimitado à sessão
Rollback preserva tudoRollback apaga histórico
Cada salto rastreadoSem trajetória

MemoV Time

Recursos

  • MCP de um clique — Funciona com qualquer agente de codificação IA
  • VibeGit para Agentes — Rastreamento automático de prompts, contexto e diffs sem commits manuais
  • Controle de versão — Branch, rollback, replay de qualquer interação
  • Mantenha Git limpo — Linha temporal sombra .mem, zero poluição em .git
  • UI Visual — Diga "mem ui" no chat, e veja em http://localhost:38888
  • Privacidade primeiro — Local, sem banco de dados, sem overhead. Use .memignore para excluir

MemoV Time

Início Rápido (Instalação MCP)

Pré-requisitos

Instale uv primeiro:

# macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Instalar Git (se não instalado) winget install --id Git.Git -e --source winget

Claude Code

Execute no diretório raiz do seu projeto:

claude mcp add mem-mcp --scope project -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)

Codex

Execute no diretório raiz do seu projeto:

codex mcp add mem-mcp -- uvx --from git+https://github.com/memovai/memov.git mem-mcp-launcher stdio $(pwd)
VS Code

Crie .vscode/mcp.json na raiz do seu projeto:

{ "servers": { "mem-mcp": { "type": "stdio", "command": "uvx", "args": [ "--from", "git+https://github.com/memovai/memov.git", "mem-mcp-launcher", "stdio", "${workspaceFolder}" ] } } }
Cursor

Vá para Files > Preferences > Cursor Settings > MCP, então adicione:

{ "mcpServers": { "mem-mcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/memovai/memov.git", "mem-mcp-launcher", "stdio", "${workspaceFolder}" ] } } }
Antigravity

Nota: O Antigravity não suporta a variável "${workspaceFolder}". Insira manualmente o caminho absoluto do diretório do seu projeto.

Vá para Settings > MCP e adicione:

{ "mcpServers": { "mem-mcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/memovai/memov.git", "mem-mcp-launcher", "stdio", "/absolute/path/to/your/project" ] } } }

Substitua /absolute/path/to/your/project pelo caminho absoluto real do diretório do seu projeto (ex.: /Users/username/projects/my-project no macOS/Linux ou C:\Users\username\projects\my-project no Windows).

Com VectorDB (modo RAG) 🚧 WIP

Para habilitar busca semântica, validação e ferramentas de depuração, instale com extras [rag]:

Claude Code:

claude mcp add mem-mcp --scope project -- uvx --from "git+https://github.com/memovai/memov.git[rag]" mem-mcp-launcher stdio $(pwd)

VS Code / Cursor: Altere o argumento --from para:

"git+https://github.com/memovai/memov.git[rag]"

Dicas Importantes

Adicionar uma Regra — Para salvar snapshots automaticamente após cada interação, adicione uma regra aos seus agentes de codificação:

  • Cursor: Cursor Settings > Rules
  • Claude Code: CLAUDE.md
  • Ou o equivalente no seu cliente MCP

Regra de exemplo:

After completing any interaction, always call `use mem snap` to save the snapshot.

Web UI, Apenas diga Use mem ui🤌

Apenas diga "use mem ui" no chat — abre em http://localhost:38888 com visualização de linha temporal, filtragem de branches, visualizador de diffs e salto para qualquer snapshot.

Instalação CLI (Opcional)

Se você quer usar a ferramenta CLI mem diretamente:

Instalação de uma linha

curl -fsSL https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash

Arquitetura

MemoV segue uma arquitetura de três camadas com MemovManager como orquestrador central, o servidor MCP como camada adaptadora para agentes IA e um sistema RAG opcional para busca semântica.

Arquitetura MemoV

Ferramentas MCP

Operações Principais

  • snap() - Registra cada interação do usuário
  • mem_ui() - Lança a Web UI
  • mem_history() - Ver histórico
  • mem_jump() - Saltar para um snapshot

Ferramentas RAG (requer extras [rag])

  • mem_sync() - Sincronizar com VectorDB
  • validate_commit() - Validar commits
  • vibe_debug() - Depuração com busca RAG
  • vibe_search() - Busca semântica

Licença

Licença MIT. Veja LICENSE.