WorkGraph

WorkGraph は、ユーザーが選択したワークスペースを、ファイルを移動・アップロードせずにインデックス化します。階層的な Portfolio -> Area -> Project -> Artifact グラフを構築し、ローカルブラウザ、CLI、読み取り専用の MCP サーバーを通じて公開し、必要に応じて Obsidian ナビゲーションレイヤーを生成できます。

これは、大規模で研究とエンジニアリングが混在するワークスペースをナビゲートするための個人用の vibe-coded ツールとして始まりました。公開版では、マシン固有の前提を排除しつつ、オリジナルを有用にしていたワークフロー（高速なクロスプロジェクト検出、明示的な来歴、ソースファイル・再構築可能なインデックス・厳選されたメモリの厳格な分離）を維持しています。

機能

• ドリルダウンマップ: ポートフォリオ全体からエリア、プロジェクト、ドキュメント、コンセプト、ツール、ワークフローへ移動できます。

• ローカル検索: プロジェクトメタデータと選択したテキストファイルに対する SQLite FTS 検索。

• 説明可能なリンク: 明示的なパス参照と、信頼度の低い共有コンセプトの提案を区別します。

• 読み取り専用 MCP: Codex、Kimi、Reasonix、または他の MCP クライアントがプロジェクトコンテキストと再利用可能な過去の作業を照会できるようにします。

• オプションの Obsidian レイヤー: ワークスペースをコピーせずに、ナビゲーションページ、コンセプトインデックス、メモリミラー、Canvas を生成します。

• プライバシー制御: トップレベルのエリア全体をメタデータのみとしてマークし、インデックス化されたテキストから一般的な認証情報パターンを編集できます。

• ホスト型サービスなし: Web UI はループバックにバインドされ、ベンダー提供のフロントエンドアセットを使用します。実行時インデックス化にネットワークやモデル API は不要です。

Related MCP server: code-graph

クイックスタート

Windows インストーラー

Releases から最新のソースアーカイブをダウンロードし、解凍してから次を実行します:

.\scripts\Install-WorkGraph.ps1 -WorkRoot "D:\MyWorkspace" -Start

オプションの統合は明示的です:

.\scripts\Install-WorkGraph.ps1 `
  -WorkRoot "D:\MyWorkspace" `
  -ObsidianVault "$HOME\Documents\My Vault" `
  -SensitiveArea Personal,Finance `
  -ConfigureClients `
  -Start

インストーラーはプロジェクトローカルの .venv を作成し、config/workgraph.json を書き込み、最初のインデックスを構築し、必要に応じて MCP サーバーを登録します。既存のクライアントファイルは変更前にバックアップされます。

手動インストール

uv venv .venv
uv pip install --python .\.venv\Scripts\python.exe -e .
.\.venv\Scripts\python.exe -m workgraph.cli init --work-root "D:\MyWorkspace"
.\.venv\Scripts\python.exe -m workgraph.cli refresh
.\.venv\Scripts\python.exe -m workgraph.cli serve

http://127.0.0.1:8765/ を開きます。macOS または Linux では、同じモジュールコマンドで .venv/bin/python を使用します。

ワークスペースモデル

デフォルトの規約では、最初のディレクトリレベルをエリア、2番目をプロジェクトとして扱います:

MyWorkspace/
├── Research/
│   ├── ClimateModel/
│   └── KnowledgeGraph/
├── Engineering/
│   ├── RobotArm/
│   └── CFDStudy/
└── Writing/
    └── OpenSourceGuide/

より深い、または混在したレイアウトは、project_layout.area_depths と project_layout.group_depths で記述できます。config/workgraph.example.json と合成された examples/demo-workspace を参照してください。

日常コマンド

.\scripts\Refresh-WorkGraph.ps1
.\scripts\Start-WorkGraph.ps1 -Open
.\scripts\Status-WorkGraph.ps1
.\scripts\Stop-WorkGraph.ps1

.\.venv\Scripts\python.exe -m workgraph.cli search "finite element OCR"
.\.venv\Scripts\python.exe -m workgraph.cli context "ClimateModel"
.\.venv\Scripts\python.exe -m workgraph.cli related "KnowledgeGraph"
.\.venv\Scripts\python.exe -m workgraph.cli reuse "document rendering"

MCP ツール

work_map、project_context、related_projects、find_reuse、work_search、graph_stats は読み取り専用です。自動登録は現在、Windows 上の Codex、Kimi Code/Kimi Work、Reasonix を対象としています:

.\.venv\Scripts\python.exe -m workgraph.cli configure-clients

他のクライアントでは、この stdio コマンドを登録します:

<absolute path to python> -m workgraph.mcp --config <absolute path to workgraph.json>

信頼境界

• ワークスペースは常に真実のソースです。WorkGraph はソースファイルを移動または削除しません。

• SQLite データベースと生成された Obsidian ページは使い捨てのインデックスです。

• 機密エリアはファイル名と集計メタデータを公開しますが、その内容はインデックス化されません。

• .git、.venv、node_modules、ビルドキャッシュなどの生成フォルダは、意味分析から除外されます。

• バイナリの Office ファイル、PDF、モデル、メディアは v0.1 ではメタデータのみです。

• related_to エッジは発見のヒントであり、証拠ではありません。主張に依存する前にソースパスをたどってください。

機密資料をインデックス化する前に、完全なプライバシーモデルをお読みください。

開発

.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe -m compileall -q src tests

WorkGraph はランタイム標準ライブラリのみを使用します。Cytoscape.js と Lucide はオフライン UI 用にベンダー提供されており、その通知は THIRD_PARTY_NOTICES.md にあります。

開発は人間主導で AI 支援です。メンテナーはアーキテクチャ上の決定、プライバシー境界、検証、リリース、および受け入れられたすべての変更を所有します。生成されたコードも、他の貢献と同様のレビューとテスト要件を受けます。

貢献は、焦点を絞った issue とプルリクエストを通じて歓迎します。CONTRIBUTING.md、SECURITY.md、およびロードマップを参照してください。

ライセンス

Apache License 2.0。LICENSE を参照してください。