[!TIP] 初めての方へ。クイックスタートでは、
npm installから最初の永続的なエージェントセッションを開始するまで約60秒で完了します。
Waypathは、コーディングエージェントとソロ開発者のためのローカルファーストな知識エンジンです。プロジェクトの決定事項、エンティティの関係、セッションアーティファクトを単一のSQLiteファイルに保存し、軽量なCLIを通じて、Claude Code、Codex、またはMCPクライアントなどのあらゆるエージェントホストにグラフ認識型で真実優先のコンテキストを提供します。
クラウドメモリサービスとは異なり、Waypathは以下の特徴があります：
すべてローカルマシン上で実行される
ベクターブロブではなく、正規の真実スキーマを保持する
すべてのメモリを明示的な昇格＋レビューゲートを備えたファーストクラスとして扱う
必要なランタイムサービスなしで、77 kBのnpmパッケージとして提供される
Related MCP server: ClaudeX
問題 | Waypathの回答 |
エージェントがセッションをまたいで忘れてしまう | 永続的なSQLite真実カーネル |
RAGが関連性のないチャンクを返す | グラフ拡張を伴うFTS5 + RRFハイブリッドランキング |
メモリサービスが静かにハルシネーションを起こす | 明示的な |
クラウドへのロックイン、データ流出 | すべては所有する1つのローカル |
ホストごとのツール (Claude, Codex, Cursor) | 単一のファサード、軽量なホストシム、ネイティブMCPサーバー |
[!IMPORTANT] Node.js ≥ 22が必要です。Node 22.5以降ではネイティブの
node:sqliteドライバーが利用可能です。それ以前の22.xバージョンでは、自動的にbetter-sqlite3にフォールバックします。
npm install -g waypath確認:
waypath --help
waypath source-status --json1. セッションのブートストラップ (Codexの例):
waypath codex --json \
--project my-project \
--objective "ship v2 of the retrieval pipeline" \
--task "refactor hybrid ranker" \
--store-path ~/.waypath/my-project.db2. 関連するコンテキストの呼び出し:
waypath recall --query "hybrid ranker decisions" --json3. 抽出された洞察をキャプチャし、レビューを通じて昇格させる:
waypath page --subject "hybrid ranker v2 design"
waypath promote --subject "hybrid ranker v2 design"
waypath review-queue --json4. MCPサーバーとして実行 (Claude Code、Cursor、あらゆるMCPクライアント向け):
waypath mcp-server --store-path ~/.waypath/my-project.db$ waypath codex --json --project auth-service \
--objective "migrate to passkeys" --task "design flow"
{
"host": "codex",
"session_id": "auth-service:passkey-flow",
"context_pack": {
"truth_highlights": {
"decisions": [
"Use WebAuthn level 2 with user verification required",
"Argon2id for password fallback hashing"
],
"entities": ["UserSession", "AuthGateway", "RefreshToken"],
"contradictions": []
},
"recent_pages": [
"Session storage design — promoted 2026-04-12"
]
}
}エリア | コマンド |
セッションブートストラップ |
|
呼び出し |
|
ページ (抽出された知識) |
|
レビューガバナンス |
|
インポート / スキャン |
|
ヘルスチェック |
|
メンテナンス |
|
詳細なヘルプ: waypath --help。
Waypathは、軽量なファサードの背後にある4つの独立したカーネルで構成されています：
flowchart TD
subgraph HOST[" Host Shims "]
direction LR
CX["codex"]
CC["claude-code"]
MC["mcp-server"]
end
Facade["<b>Facade</b><br/><code>createFacade()</code>"]
TK["<b>Truth Kernel</b><br/>decisions · entities · preferences<br/>temporal validity · supersede"]
AK["<b>Archive Kernel</b><br/>evidence · content-hash dedup<br/>FTS5 index"]
ON["<b>Ontology</b><br/>graph traversal<br/>pattern expansion"]
PR["<b>Promotion Engine</b><br/>candidate review<br/>contradiction detection"]
HOST --> Facade
Facade --> TK
Facade --> AK
Facade --> ON
Facade --> PR
classDef kernel fill:#21262d,color:#c9d1d9,stroke:#30363d,stroke-width:1px
classDef facade fill:#1f6feb,color:#ffffff,stroke:#58a6ff,stroke-width:2px
classDef host fill:#161b22,color:#c9d1d9,stroke:#30363d,stroke-width:1px
class TK,AK,ON,PR kernel
class Facade facade
class CX,CC,MC host真実カーネル — 正規の決定事項、エンティティ、設定、時間的妥当性（supersede + 履歴を備えたスキーマv3）。
アーカイブカーネル — コンテンツハッシュの重複排除とFTS5全文検索インデックスを備えた生の証拠ストア。
オントロジー層 — エンティティ/決定コンテキスト拡張のためのグラフ探索（パターン: project_context, person_context, system_reasoning, contradiction_lookup）。
昇格エンジン — 候補のレビュー、矛盾検出、supersedeフロー。
単一の createFacade() が14の動詞を公開します。ホストシムが各エージェントのブートストラッププロトコルに適応させます。
Waypathはデフォルトで設定不要です。取得の重み付け、アダプターの切り替え、レビューのしきい値を調整するには、作業ディレクトリに config.toml を配置します（または WAYPATH_CONFIG_PATH でパスを指定します）：
[source_adapters]
jarvis-memory-db = true
jarvis-brain-db = false
[retrieval.source_system_weights]
truth-kernel = 1.2
[retrieval.source_kind_weights]
decision = 0.9
memory = 0.5
[review_queue]
limit = 12環境変数で上書きすることも可能です：
export WAYPATH_RECALL_WEIGHT_SOURCE_SYSTEM_TRUTH_KERNEL=1.8
export WAYPATH_REVIEW_QUEUE_LIMIT=8優先順位: 環境変数による上書き > config.toml > ビルトインのデフォルト。
Waypathは、2つ目のバイナリとしてネイティブのMCP（Model Context Protocol）サーバーを提供します：
waypath-mcp-serverまたはメインのCLI経由でも実行可能です：
waypath mcp-server --store-path ~/.waypath/project.dbMCP経由で公開されるツール: recall, page, promote, review, graph-query, source-status。
Node.js ≥ 22.0 (必須)
Node.js ≥ 22.5 推奨 — ネイティブの node:sqlite が利用可能になります
better-sqlite3 は、22.0〜22.4、またはネイティブのsqliteが利用できない環境で自動的に使用されるオプションのフォールバックです
バージョン: 0.1.0 — 初回公開リリース
テスト: 131件通過 (ユニット + 統合 + ベンチマーク)
安定したインターフェース: CLI (26コマンド), MCPサーバー, ファサードAPI
未実装: ホスト型デプロイ、マルチユーザー同期、適応型ランキングフィードバック
Waypath | クラウドメモリ (mem0, zep) | ベクターのみのRAG | |
ローカルファースト | ✓ | ✗ | 環境による |
正規の真実スキーマ | ✓ | ✗ | ✗ |
グラフ認識型のリコール | ✓ | 部分的 | ✗ |
明示的なレビューゲート | ✓ | ✗ | ✗ |
MCPサーバー内蔵 | ✓ | ✗ | ✗ |
1ファイルインストール | ✓ | サービスが必要 | 様々 |
Waypathでは、ホストシム、ソースアダプター、バグ修正の貢献を歓迎します。最初の貢献に適したIssueにはラベルが付けられています。
開発環境のセットアップ、コードスタイル、PRフローについては、CONTRIBUTING.md をお読みください。
PRを提出する前に：
npm run build
npm testMIT © TheStack.ai — LICENSE を参照してください。
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Private-by-default, local-first memory/context/task orchestrator for MCP apps and agents.
Hosted MCP memory: save sessions/decisions once, search from Claude, Cursor, ChatGPT. EU-hosted FTS.
The project brain for AI coding agents — memory, decisions, sprints, knowledge base via MCP.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/TheStack-ai/waypath'
If you have feedback or need assistance with the MCP directory API, please join our Discord server