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

MemoV - AIコーディングのメモリレイヤー

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

VibeGit🤌:プロンプト、コンテキスト、差分を自動管理

License: MIT Discord DeepWiki Twitter Follow

MemoVは、AIコーディングエージェントのためのメモリレイヤーです。プロンプト、コンテキスト、コード差分のトレーサブルGit駆動のバージョン管理を提供します。VibeGitを実現 - AIコーディングセッションの自動バージョン管理、ブランチ探索、ロールバック機能を備え、標準の.gitリポジトリを汚染しません

MemoVCheckpoints
ブランチ探索線形タイムライン
クロスセッションセッション限定
ロールバックで全履歴保持ロールバックで履歴削除
全ジャンプを追跡軌跡なし

MemoV Time

  • 💬 Discordに参加して、スマートなバイブエンジニアリングを探求しよう

機能

  • ワンクリックMCP — あらゆるAIコーディングエージェントに対応
  • VibeGit for Agents — プロンプト、コンテキスト、コード差分を手動コミットなしで自動追跡
  • バージョン管理 — ブランチ、ロールバック、任意のインタラクションをリプレイ
  • Gitをクリーンに保つ — シャドウ .mem タイムライン、.git を汚染しない
  • ビジュアルUI — チャットで「mem ui」と言うだけ、http://localhost:38888 で表示
  • プライバシーファースト — ローカル、データベース不要、オーバーヘッドなし。.memignoreで除外

MemoV Time

クイックスタート(MCPインストール)

前提条件

まず uv をインストール:

# macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Gitをインストール(未インストールの場合) winget install --id Git.Git -e --source winget

Claude Code

プロジェクトルートディレクトリで実行:

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

Codex

プロジェクトルートディレクトリで実行:

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

プロジェクトルートに .vscode/mcp.json を作成:

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

Files > Preferences > Cursor Settings > MCP に移動し、以下を追加:

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

注意: Antigravity は "${workspaceFolder}" 変数をサポートしていません。プロジェクトディレクトリの絶対パスを手動で入力してください。

Settings > MCP に移動して、次を追加します:

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

/absolute/path/to/your/project をプロジェクトディレクトリの実際の絶対パスに置き換えてください(例: macOS/Linux では /Users/username/projects/my-project、Windows では C:\Users\username\projects\my-project)。

VectorDB対応(RAGモード) 🚧 WIP

セマンティック検索、検証、デバッグツールを有効にするには、[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: --from 引数を以下に変更:

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

重要なヒント

ルールを追加 — 各インタラクション後に自動的にスナップショットを保存するには、コーディングエージェントにルールを追加:

  • Cursor: Cursor Settings > Rules
  • Claude Code: CLAUDE.md
  • またはMCPクライアントの同等の設定

ルールの例:

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

Web UI、Use mem uiと言うだけ🤌

チャットで 「use mem ui」 と言うだけ — http://localhost:38888 でタイムラインビュー、ブランチフィルタリング、差分ビューア、任意のスナップショットへのジャンプが開きます。

CLIインストール(オプション)

mem CLIツールを直接使用したい場合(手動トラッキング、履歴表示など):

ワンライナーインストール

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

またはwgetで:

wget -qO- https://raw.githubusercontent.com/memovai/memov/main/install.sh | bash

パッケージマネージャー

Homebrew (macOS/Linux)
brew tap memovai/mem brew install memov
APT (Debian/Ubuntu)
echo "deb [trusted=yes] https://memovai.github.io/memov/apt stable main" | sudo tee /etc/apt/sources.list.d/mem.list sudo apt update sudo apt install mem
YUM/DNF (Fedora/RHEL/CentOS)
sudo curl -o /etc/yum.repos.d/mem.repo https://memovai.github.io/memov/yum/mem.repo sudo dnf install mem
直接ダウンロード

お使いのプラットフォーム用の最新リリースをダウンロード:

プラットフォームダウンロード
Linux x86_64mem-linux-x86_64.tar.gz
macOS Intelmem-macos-x86_64.tar.gz
macOS Apple Siliconmem-macos-arm64.tar.gz
Windows x86_64mem-windows-x86_64.exe.zip
ソースから

Python 3.10+ と uv が必要:

git clone https://github.com/memovai/memov.git cd memov uv sync uv pip install -e . mem --help

コントリビューター向けインストール

詳細なインストール手順は docs/installation_for_dev.md をご覧ください。

アーキテクチャ

MemoVは3層アーキテクチャを採用しています。MemovManagerを中央オーケストレーターとし、MCPサーバーをAIエージェントのアダプターレイヤーとして、オプションのRAGシステムでセマンティック検索を提供します。

MemoV アーキテクチャ

MCPツール

コア操作

  • snap(user_prompt: str, original_response: str, agent_plan: list[str], files_changed: str)

    • 自動ファイル追跡で全ユーザーインタラクションを記録。未追跡vs変更済みファイルをインテリジェントに処理。
  • mem_ui(port: int = 38888)

    • http://localhost:38888 でWeb UIを起動。履歴の視覚的ブラウズ、差分表示、任意のスナップショットへジャンプ。
  • mem_history(limit: int = 20, commit_hash: str = "")

    • プロンプト、レスポンス、ファイル変更を含むmemov履歴を表示。
  • mem_jump(commit_hash: str)

    • 特定のスナップショットにジャンプし、追跡されているすべてのファイルを復元して新しいブランチを作成。

RAGツール([rag] エクストラが必要)

これらのツールは [rag] エクストラでインストールした場合のみ利用可能。

  • mem_sync()

    • 保留中のすべての操作をVectorDBに同期し、セマンティック検索機能を有効化。
  • validate_commit(commit_hash: str, detailed: bool = True)

    • プロンプト/レスポンスと実際のコード変更を比較して特定のコミットを検証。コンテキストドリフトとアラインメント問題を検出。
  • validate_recent(n: int = 5)

    • 直近N件のコミットのアラインメントパターンを検証。セッションレビューと品質保証に有用。
  • vibe_debug(query: str, error_message: str = "", stack_trace: str = "", user_logs: str = "", models: str = "", n_results: int = 5)

    • RAG検索 + マルチモデルLLM比較でデバッグ。コード履歴から関連コンテキストを検索し、複数のAIモデル(GPT-4、Claude、Gemini)を並列クエリして多様なデバッグインサイトを取得。
  • vibe_search(query: str, n_results: int = 5, content_type: str = "")

    • LLM分析なしでコード履歴(プロンプト、レスポンス、エージェントプラン、コード変更)を高速セマンティック検索。クイックコンテキスト検索に最適。

ヘルスチェック

  • GET /health
    • "OK"を返す。IDE/エージェントの準備状況チェックに有用。

ライセンス

MIT License。LICENSE を参照。