Memory export

Skill AI-Driven-R-D-Dept/user-level-memory/skills/memory-export

ユーザーレベル長期記憶 (ulm) の中身を JSONL 控えとしてエクスポート（バックアップ/別マシンへの移行/git 差分追跡）する。ユーザーが「記憶をバックアップ/エクスポート/控えを取りたい/別の環境へ移したい/同期したい」と言ったとき、または危険な一括操作（大量削除・reindex・スキーマ移行）の前に控えを取りたいときに使う。復元は import。From its SKILL.md

Install

npx -y skills add AI-Driven-R-D-Dept/user-level-memory --skill memory-export

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.0 KB, as published. Nobody here has run it

memory-export — 長期記憶を JSONL 控えにエクスポート/復元する

ユーザーレベル長期記憶 (ulm) の DB を、安定した順序の JSONL 控えに書き出すスキル。 DB が正本、JSONL は受動的なミラー（差分を git で追える形）。

なぜ必要か

本体は ~/.claude/user-memory/memory.db（SQLite）。SessionEnd フックが ulm export --quiet を自動実行しているので、通常は控えが勝手に更新される。
だが「今すぐ控えを取りたい」「別マシンへ移したい」「危険な一括操作の前に保全したい」「記憶の変化を git で差分追跡したい」ときは、明示的に export する。

いつ使うか

ユーザーが「記憶をバックアップ / エクスポート / 控え / 別環境へ移行 / 同期」と言ったとき
大量削除・reindex・スキーマ移行・モデル変更など、戻せない操作をする前
別マシン/別アカウントへ記憶を持っていきたいとき（export → 転送 → import）

やり方（エクスポート）

CLI は ${CLAUDE_PLUGIN_ROOT}/bin/ulm.js。

node "${CLAUDE_PLUGIN_ROOT}/bin/ulm.js" export

出力先は固定で $ULM_HOME/export/（既定 ~/.claude/user-memory/export/）。出力先指定オプションは無い。
書き出されるファイル:
- observations.jsonl / states.jsonl / candidates.jsonl / refs.jsonl（公開分）
- observations.secret.jsonl / states.secret.jsonl（機密分・別ファイル）
- meta.json（スキーマ版・統計・エクスポート時刻）
- .gitignore（secret ファイルを除外するよう自動生成）
スクリプトや自動処理では --quiet でファイル一覧を抑制。
実行後に ⚠ … 機密の疑い … 警告が出たら、その観測を obs secret <id> で secret 化してから再 export する。

やり方（復元/移行）

別マシンや復旧時は、export ディレクトリを渡して取り込む:

node "${CLAUDE_PLUGIN_ROOT}/bin/ulm.js" import <export-dir>

既存 ID は INSERT OR IGNORE でスキップ（重複は安全に無視）。
不正 id / 長すぎる本文 / 不正 status / 壊れた JSON 行は可視的にスキップ（件数を表示）するので、出力の スキップ 行を確認する。
取り込んだ行は取込時ゲートで機密を再判定し secret 化される。source 表示で出自を区別できる。

セキュリティ（最重要）

*.secret.jsonl は機密そのもの。自動生成の .gitignore で除外されるが、export ディレクトリを別の場所へコピー/転送/共有するときは secret ファイルを絶対に含めない（git に add しない・クラウドに上げない）。
出力先 $ULM_HOME/export/ は既定でリポジトリ外（~/.claude 配下）。ULM_HOME をリポジトリ内に向けている場合は、secret ファイルがコミットされないか必ず確認する。
機密の疑い警告は「取りこぼし前提の多層防御」の一環。無視せず対応する。
別マシンへ移すときは、転送経路（USB/クラウド/scp 等）でも secret ファイルの扱いに注意する。

実行後

エクスポート先のパスと、警告が出たかどうかを簡潔に伝える。機密分が含まれることと、その取り扱い注意を必ず添える。