スレッド

スレッドは会話のレイヤーです。 AIセッションで起きたことの元の流れをそのまま保ちます。 何を尋ね、ツールが何を答え、作業がどのように進んだのかを記録します。

その真の価値は単なる保存にとどまりません。 スレッドは、過去の会話を検索し、正確なコンテキストを再び開き、長く残る部分をメモリへと蒸留できるときに役立ちます。

最初の役立つスレッド

初めての方は、まず次のいずれかを行ってください。

• すでに大切にしている会話を1つインポートする
• 対応しているツールに1つのセッション全体をキャプチャさせる
• ブラウザ拡張機能を通じてWebの会話を1つキャプチャする

その後、そのスレッドを開き、役立つメモリを1つ蒸留してください。 これが中心となるワークフローです。

スレッドの閲覧

スレッドビューには、インポートしたすべての会話が1か所に表示されます。

• 内容またはタイトルでスレッドを検索する
• ソース（Claude Code、ChatGPT、Cursorなど）でフィルタリングする
• 重要なスレッドをピン留めしてアクセスしやすくする
• 任意のスレッド内の個々のメッセージを表示する

サイドバーからスレッドを開くか、Cmd + 3（macOS）を押してください。

スレッドの蒸留

スレッドをメモリへつなぐ中心的なワークフローです。 任意のスレッドを開き、蒸留を開始します。 システムは会話から個々のメモリを抽出し、それぞれに独自のタイトル、ラベル、重要度スコアを付けます。 抽出されたメモリはナレッジグラフに入り、他のすべてと並んで検索可能になります。

こうして、何時間ものAIとの会話が、後から見つけられるつながった知識になります。

通常サイズのスレッドでは、蒸留はすぐに実行されます。 非常に大きなスレッドでは、Memは代わりにスマートバックグラウンド蒸留を提供します。 これは数秒後に開始され、ナレッジエージェントがスレッドを段階的に読み、その後、長く残るメモリをより少ないセットで保存します。 これは短いスレッドの蒸留より遅いですが、1つのフォアグラウンドリクエストにすべてを一度に読ませるよりはるかに安全です。

スレッドがMemに届く仕組み

スレッドはいくつかの異なる経路でNowledge Memに入ることができます。 それらは関連していますが、同じものではありません。

• 専用のプラグインと拡張機能: Claude Code、Grok Build、Codex、Gemini CLI、OpenClaw、Hermes Agent、Alma、Cursor、Droid、OpenCode、Craft Agent、Copilot CLIなどのツール固有の統合
• ローカル検出/バックフィル: Memを実行しているマシン上の、対応するコーディングエージェントの会話に対するアプリ内インポート
• 共有スキルまたはプロンプトパック: npx skillsのような再利用可能なセットアップ
• ブラウザキャプチャ: Exchange拡張機能は、パネルで使用しているフォーカスされたWebセッション（チャットアカウント全体ではありません）で動作します。 詳しくは既存の会話をインポートするをご覧ください
• 手動インポート: ファイル、エクスポート、API呼び出し、CLIインポート

理解しておくべき主な点は次のとおりです。

• 完全なセッションキャプチャとは、Memがそのツールから実際に記録された会話を受け取ることを意味します
• ハンドオフサマリーとは、Memが完全なセッションの代わりに簡潔な継続メモを保存することを意味します

共有スキルもここで重要です。 それらは多くのエージェントで役立ちますが、そのホストランタイムが読み取り可能なセッションファイルや安定したトランスクリプトAPIを公開していない限り、完全なセッションキャプチャを正直に約束することはできません。

ほとんどのユーザーに必要なルールは1つだけです。

• 使用しているツールにすでに実際のスレッド保存経路があるなら、それを使う
• 現時点でハンドオフサマリーしかサポートしていないなら、そのメンタルモデルを明確に保ち、完全な履歴にはインポートまたはnmem t syncを使う

自動同期

アプリ内検出

ローカルのコーディングアシスタントからの会話をマシン上でスキャンします。 ファイルのエクスポートは不要です。

ネイティブキャプチャと保存経路

統合ごとに、スレッド保存の動作は異なります。 完全なセッションキャプチャをサポートするものもあれば、ライフサイクルイベントで自動キャプチャするものもあります。 DroidとCursorは現在、プラグインのハンドオフサマリーを完全な会話インポートとは別に保っています。

ファイルインポート

一括インポート

スレッド → インポートで、アカウント履歴をインポートを選択します。 ChatGPT、Claude、DeepSeek、その他対応ベンダーのエクスポートはすべてこの同じ入口を使用します。

単一スレッド

ファイルから1つの会話をインポートします。

会話Markdownフォーマット

会話インポート用のポータブルフォーマットです。 ## User / ## Assistantヘッダーを書き出すツールであれば、Nowledge Memが読み取れるファイルを生成します。

最小例

最も単純な有効なファイル、2ターン、フロントマターなし:

## User

What is Python's GIL?

## Assistant

The Global Interpreter Lock (GIL) is a mutex in CPython that allows only one thread to execute Python bytecode at a time. This means CPU-bound multi-threaded programs won't see speedups from threading: use multiprocessing or async I/O instead.

完全な例

任意のYAMLフロントマターとシステムメッセージ付き:

---
title: Python Async Patterns
source: chatgpt
date: 2025-06-15
---

## System

You are a senior Python developer who explains concepts clearly.

## User

How does async/await work in Python?

## Assistant

Python's `async`/`await` lets you write concurrent code that doesn't block while waiting for I/O. An `async def` function returns a coroutine, and `await` pauses it until the result is ready, meanwhile other coroutines can run.

## User

When should I use asyncio vs threading?

## Assistant

Use **asyncio** for I/O-bound work (HTTP requests, database queries, file reads): it's lighter and scales better than threads. Use **threading** when you need to call blocking libraries that don't support async. Use **multiprocessing** for CPU-bound work.

フォーマットのルール

• ヘッダー: ## User、## Assistant、または## System、レベル2見出し、メッセージごとに1つ
• 内容: ヘッダー間のすべてが1つのメッセージです。 Markdownフォーマット、コードブロック、リストはそのまま保持されます
• フロントマター: 先頭の任意のYAMLブロック。 対応フィールド: title、source、date、すべて任意
• 検出: 少なくとも1つの## Userまたは## Assistantヘッダーを含むファイルは、自動的に会話として認識されます
• フォールバック: 認識されたヘッダーのないファイルは、単一のドキュメントメッセージとしてインポートされます
• 大文字小文字: ロール名は大文字小文字を区別せずに照合されます（## userと## Userのどちらも機能します）

インポートAPI

POST /threads/importはJSONメッセージまたは会話Markdownを受け付け、単一モードとバッチモードがあります。

単一スレッド（JSONメッセージ）

curl -X POST http://127.0.0.1:14242/threads/import \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Conversation",
    "source": "chatgpt",
    "messages": [
      {"role": "user", "content": "Hello!"},
      {"role": "assistant", "content": "Hi there! How can I help?"}
    ]
  }'

単一スレッド（Markdown）

curl -X POST http://127.0.0.1:14242/threads/import \
  -H "Content-Type: application/json" \
  -d '{
    "markdown_content": "## User\n\nHello!\n\n## Assistant\n\nHi there! How can I help?"
  }'

バッチインポート

curl -X POST http://127.0.0.1:14242/threads/import \
  -H "Content-Type: application/json" \
  -d '{
    "threads": [
      {
        "title": "Thread 1",
        "messages": [
          {"role": "user", "content": "Hello"},
          {"role": "assistant", "content": "Hi"}
        ]
      },
      {
        "title": "Thread 2",
        "markdown_content": "## User\n\nGoodbye\n\n## Assistant\n\nSee you!"
      }
    ]
  }'

スレッドIDは省略時に自動生成されます。 タイトルは、利用可能な場合はmarkdownフロントマターから推測されます。

CLI

nmem CLIは、ファイル、JSON、またはstdinからのスレッドインポートをサポートします。

# Import a conversation markdown file
nmem t import --file conversation.md

# Import with explicit title and source
nmem t import --file chat.md --title "Python Async" --source chatgpt

# Import from JSON messages
nmem t import --messages '[{"role":"user","content":"Hello"},{"role":"assistant","content":"Hi"}]'

# Bulk JSON from Raycast AI (raycast-ai-exporter output)
nmem t import --file ~/Desktop/raycast_ai_chats.json

# Pipe markdown from stdin
cat conversation.md | nmem t import --stdin --title "Piped Conversation"

すべてのオプションについてはnmem t import --helpを実行してください。 完全なコマンド一覧はCLIリファレンスをご覧ください。

ブラウザ拡張機能

Nowledge Mem Exchange拡張機能は、ブラウザの対応するAIチャットページで、拡張機能で実際に使用しているセッション（たとえばサイドパネルで開いたタブ）上で動作します。 Webチャット履歴全体の一括ダウンローダーではありません。 そのためには、各ベンダーのエクスポートとMemの一括インポートを使用するか、**既存の会話をインポートする**をご覧ください。 自動キャプチャ、手動蒸留、現在のスレッドのバックアップについては、ブラウザ拡張機能ガイドで説明しています。

MCPツール

MCPスレッドツールは、Memにすでに存在するスレッドを検索、読み取りします。 ローカルのコーディングエージェントのトランスクリプトをキャプチャするには、そのツールのネイティブコネクタを使用してください。 古いセッションをバックフィルするには、エージェントを実行しているクライアントマシンでnmem t sync --from <source>を実行します。 対応ソースにはclaude-code、codex、craft-agent、cursor、gemini-cli、grok、hermes、kimi-code、kimi-work、mimo-code、omp、opencode、piが含まれます。 これによりトランスクリプトの検出がローカルに保たれ、正規化されたスレッドがMemサーバーへアップロードされます。

次のステップ

• メモリ: 蒸留後に起こること。 知識の作成、検索、整理
• ライブラリ: メモリと並べてドキュメントをインポート
• ブラウザ拡張機能: WebのAIプラットフォームから会話をキャプチャ
• コネクタ: ネイティブコネクタ、再利用可能なパッケージ、またはMCPを通じてAIツールを接続
• APIリファレンス: 完全なREST APIドキュメント