Session Forge

session-forge

ゼロから始める必要はありません。 AI コーディングアシスタント向けの永続的なセッションインテリジェンスです。

Session-forge は、セッションをまたいで保持されるメモリを AI コーディングアシスタントに提供します。判断、行き詰まった方法、ユーザーの好み、セッションの状態を記録するため、すべての会話が最初からやり直しではなく、前回の続きから始まります。

Claude Code、Cursor、Windsurf、および MCP 対応のあらゆるクライアントで利用できます。

---

できること

• セッションのクラッシュ復旧 — 作業をチェックポイントとして保存し、中断したところから再開できます
• 判断の記録 — Y ではなく X を選んだ理由を記録し、後から検索できます
• 行き詰まった方法の記録 — 同じデバッグの失敗を二度と繰り返しません
• ユーザープロフィール — AI が名前、好み、プロジェクトを記憶します
• セッションジャーナル — タスクだけでなく、そこに至る過程を記録します
• コンテキストの完全な呼び出し — すべての情報を一度の呼び出しで新しいセッションに読み込めます
• データ管理 — 古いエントリーの整理、全データのエクスポート、統計の表示ができます

クイックスタート

Claude Code

claude mcp add session-forge -- npx session-forge

Cursor / Windsurf

MCP の設定に追加します。

{
  "mcpServers": {
    "session-forge": {
      "command": "npx",
      "args": ["-y", "session-forge"]
    }
  }
}

これだけです。データベースも、Docker も、設定ファイルも必要ありません。

---

15 個のツール

セッション

ツール	説明	必須項目
session_checkpoint	クラッシュ復旧のため、作業中の状態を保存します	task, intent, next_steps
session_restore	前回のセッションで中断した作業がないか確認します	—
session_complete	セッションをアーカイブし、完了としてマークします	—

プロフィール

ツール	説明	必須項目
profile_get	現在のユーザープロフィールを取得します	—
profile_update	名前、好み、プロジェクト、メモを更新します	—

ジャーナル

ツール	説明	必須項目
journal_entry	成果や苦労した点を含むセッションの概要を記録します	summary
journal_recall	最近のセッションジャーナルを取得します	—

判断

ツール	説明	必須項目
decision_record	選択肢と理由を含む重要な判断を記録します	choice, reasoning
decision_search	キーワードで過去の判断を検索します（limit パラメーターに対応）	query

行き詰まった方法

ツール	説明	必須項目
dead_end_record	失敗した方法と、そこから得た教訓を記録します	attempted, why_failed
dead_end_search	同じ失敗を避けるため、過去に行き詰まった方法を検索します（limit パラメーターに対応）	query

コンテキスト

ツール	説明	必須項目
full_context_recall	プロフィール、ジャーナル、判断、行き詰まった方法など、すべてを取得します。省略可能な project フィルターに対応しています。	—

データ管理

ツール	説明	必須項目
data_manage	古いエントリーの整理、全データのエクスポート、ストアの消去、統計の表示を行います	action
data_list	保存されたエントリーを番号付きの概要で閲覧します。検索フィルターに対応しています。	store
data_delete	data_list の出力から、インデックスを指定してエントリーを削除します	store, entry_index

data_manage のアクション：

• stats — すべてのストアのエントリー数とスキーマバージョンを表示します
• export — すべてのデータを JSON として出力します
• prune — N 日より古いエントリーを削除します（デフォルト：90）
• clear — 指定したストア（journal、decisions、dead_ends、profile、または all）を消去します

data_list + data_delete のワークフロー：

1. data_list で store="decisions" を指定 — すべての判断を番号付きリストで表示します
2. data_list で store="decisions"、query="minecraft" を指定 — キーワードで絞り込みます
3. data_delete で store="decisions"、entry_index=3 を指定 — リストからエントリー #3 を削除します

---

session-forge を選ぶ理由

	session-forge	基本的なメモリ MCP	エンタープライズツール
セットアップ	npx session-forge	さまざま	Docker ＋ データベース
行き詰まりの追跡	はい	いいえ	いいえ
意思決定の記録	はい	いいえ	一部
セッションのクラッシュからの復旧	はい	一部	はい
データ管理	はい	いいえ	一部
ユーザープロフィール	はい	一部	いいえ
依存関係	2（SDK ＋ zod）	さまざま	5～10 以上
インフラストラクチャ	ゼロ（プレーンな JSON）	SQLite/ONNX/ベクトル DB	PostgreSQL ＋ Redis
ツール	厳選された 15 個	4～9 個	37 個以上

---

設定

環境変数

変数	デフォルト	説明
SESSION_FORGE_DIR	~/.session-forge or %APPDATA%\session-forge	データの保存場所を上書きします
SESSION_FORGE_STALE_HOURS	24	非アクティブなセッションが自動アーカイブされるまでの時間

---

ストレージ

すべてのデータは、プレーンな JSON ファイルとしてローカルに保存されます。

プラットフォーム	場所
Linux / macOS	~/.session-forge/
Windows	%APPDATA%\session-forge\

SESSION_FORGE_DIR 環境変数で上書きできます。

SESSION_FORGE_DIR=/custom/path npx session-forge

ファイル：

~/.session-forge/
  profile.json        # User preferences and projects
  journal.json        # Session summaries (last 100)
  decisions.json      # Decision log (last 200)
  dead-ends.json      # Failed approaches (last 100)
  sessions/
    active.json       # Current checkpoint
    history/          # Archived sessions

データファイルには、将来の移行に対応するための schema_version フィールドが含まれます。

---

CLAUDE.md テンプレート

各ツールをいつ呼び出すか AI に教えるため、プロジェクトの CLAUDE.md に次の内容を追加してください。

## Session Flow

### Fresh session
1. Call `full_context_recall` — get profile, journals, decisions, dead ends
2. Call `session_restore` — check for interrupted work

### During work
- `decision_record` — when making a significant architectural choice
- `dead_end_record` — when something fails and we learn why
- `session_checkpoint` — every 10-15 tool calls during long sessions

### Session end
1. Call `journal_entry` — record what happened
2. Call `session_complete` — archive the checkpoint

---

変更履歴

v2.0.1

• 免責事項を追加：session-forge は SessionForge LLC（sessionforge.dev）と一切関係ありません

v2.0.0

• ナレッジグラフ — related_dead_ends フィールドと led_to_decision フィールドを使って、意思決定と行き詰まりを相互に関連付けます
• スコア付き検索 — ファジーマッチング、タグによる絞り込み、AND/OR 検索モード、関連度スコアリングを追加（基本的な文字列マッチングから置き換え）
• 使用統計 — 回避した行き詰まり、実行した検索、復旧したセッションを追跡します
• MEMORY.md 同期 — full_context_recall で MEMORY.md を読み込み、メモリに保存すべき意思決定や行き詰まりを提案できます
• 強化されたチェックポイント — errors_encountered、key_findings、decisions_made、dead_ends_hit を追跡するようになりました
• 新しいストレージモジュール：links.js、search.js、stats.js、migrate.js
• スキーマを v2 に更新

v1.2.0

• data_list ツールを追加 — 保存された項目を番号付きの概要で閲覧でき、任意で検索フィルターを指定できます
• data_delete ツールを追加 — インデックスを指定して個々の項目をピンポイントで削除できます
• 保存されている内容を正確に確認し、必要な項目を削除できるようになりました

v1.1.0

• data_manage ツールを追加（統計、エクスポート、経過時間による整理、ストアごとの消去）
• full_context_recall に project フィルターを追加
• decision_search と dead_end_search に limit パラメーターを追加
• JSON の読み込み時にエラーログを追加（以前は解析エラーを黙って無視していました）
• SESSION_FORGE_STALE_HOURS による設定可能なセッションタイムアウトを追加
• 将来の移行に対応するため、データファイルに schema_version を追加
• コードと package.json 間のバージョン不一致を修正

v1.0.2

• 初回の一般公開

---

ライセンス

MIT

---

重要なお知らせ

session-forge は SessionForge LLC（sessionforge.dev）と一切関係ありません。

session-forge は、SessionForge LLC が登場する前の 2026 年 2 月 7 日 に npm で初めて公開されました。同社の製品や会社とは一切関係ありません。

重要な理由は次のとおりです。session-forge は、すべてのデータをプレーンな JSON ファイルとしてお使いのマシン上にローカル保存します。データがコンピューターから外部に送信されることはありません。アカウントも、サーバーも、第三者も必要ありません。

AI セッションのデータ、コーディングの習慣、ターミナルへのアクセスを自社のサーバー経由で行うよう求めるサービスがあれば、次のことを考えてみてください。そのデータに誰がアクセスでき、何に利用しているのでしょうか？

ワークフローも、意思決定も、コードも、あなたのものです。あなたの管理下にあるマシンに保存されるべきです。session-forge はその考えに基づいて開発され、これからもその方針を守ります。

---

Jacob Terrell が開発