Geneziz ドキュメント
Geneziz のインストール・セットアップ・使い方。X.com、GitHub、YouTube、Reddit などからの保存を検索可能な Markdown としてキャプチャする local-first のナレッジベースで、AI アシスタント向けの MCP server を同梱。
概要
Geneziz はlocal-first のナレッジベースで、散在する保存を構造化・検索可能なセカンドブレインに変えます。X.com(ブックマーク)、GitHub スター、YouTube、Reddit、Instagram、TikTok、Cosmos、Hacker News、RSS フィードからの保存に加え、ブラウザから保存したページもキャプチャし、各アイテムを AI でエンリッチして、すべてをあなたのマシン上のプレーンな Markdown ファイルとして保存します。
アーカイブされた各アイテムにはカテゴリ・タグ・一行の説明・優先度レーティングが付き、デスクトップアプリ(または web ビューアー)に届いて、そこで閲覧・フィルター・検索できます。組み込みの MCP server があなたのナレッジベースを Claude Code、Cursor、Windsurf などの AI アシスタントに公開するので、コーディング中のセッションで保存した内容を参照できます。
データはあなたのマシンから一切外に出ません。ファイルは grep 可能、git で追跡可能、どんなテキストエディターでも読めます。
インストール
お使いのプラットフォーム向けの最新デスクトップビルドをダウンロードしてください。Python も Node.js も不要です - アプリは自己完結型のネイティブインストーラーとして提供されます。
| プラットフォーム | ファイル | 備考 |
|---|---|---|
| Windows x64 | .exe インストーラー(geneziz.app から) | サポートビルド |
| macOS | .dmg | ネイティブユニバーサルビルド |
インストーラーを実行したあと、Geneziz を起動すると初回セットアップウィザードが自動的に表示されます。
初回セットアップ
セットアップウィザードは 4 つの情報を収集します。どれでもスキップでき、後から Settings で戻れます。
ライセンスキー
ライセンスを GNZ-XXXX または GNZD-XXXX 形式で入力してください。ライセンスは $99 の一回払いで、最大 3 デバイスで有効化できます。
X.com
Save to Geneziz ブラウザ拡張機能(Geneziz デスクトップアプリに同梱)をインストールしてください。ログイン済みの X.com セッション内で閲覧中にキャプチャします。Geneziz がブラウザの保存クッキーを読み取ることは一切なく、データがクラウドに送られることもありません。公式 API を使うソース(GitHub)は自分のトークン/OAuth で接続します。
AI プロバイダー
Geneziz がアイテムをどうエンリッチするかを選びます。4 つのモードに対応しています:
- Geneziz AI プロキシ(ホスト型) - Geneziz API を使用し、同梱のクレジットを消費、キー不要
- Anthropic - ご自身の Anthropic キーを使用
- OpenAI-compatible - OpenAI、OpenRouter、GLM、その他の互換エンドポイント
- Ollama - 完全にローカル
独自キーの持ち込み (BYOK) は、クレジット消費なしの無制限処理を意味します。
GitHub トークン
任意です。personal access token を貼り付けると、GitHub のスターを同期できます。指定しない場合、GitHub のステップはスキップされます。
データのインポート
X.com のブックマーク
X.com のキャプチャはブックマークのみで、ログイン済みセッション内のブラウザ拡張機能を通じて実行されます(初回セットアップを参照)。CLI の fetch は接続済みのソースとアカウントをループします:
geneziz fetch --source github # アクティブな GitHub アカウントすべて
geneziz fetch --source github --account gh-work # 1 つだけ
GitHub のスター
スターをつけたリポジトリを同期します。各リポジトリはカテゴリ分けされ、Markdown のナレッジファイルとして整理されます。
geneziz sync
Pocket の JSON エクスポートをインポートします。Pocket の web UI からライブラリをエクスポートして、次に:
geneziz import-pocket --input path/to/pocket-export.json
CLI リファレンス
Geneziz には完全な CLI が同梱されています。最新の一覧とフラグは geneziz --help を実行してください。
| コマンド | 説明 |
|---|---|
--version | バージョン情報を表示 |
init | 設定ファイルを作成 |
setup | 対話型セットアップウィザード |
status | 統計を表示 (ブックマーク、ツール、記事、メディア) |
fetch | 接続済みソースから取得(マルチアカウント対応) |
process | 保留中のブックマークを処理 (AI または --no-ai) |
sync | ブックマーク + GitHub スターを同期 |
enrich | 最小限のナレッジファイルを AI でエンリッチ |
hydrate | ツイート / 記事からメディアをダウンロード |
gaps | ナレッジベースの欠落を検出して修復 |
index | 閲覧 + 検索インデックスを再構築 |
web | web ビューアーの開発サーバーを起動 |
build | web ビューアーを本番用にビルド |
serve | ビルド済みビューアーをサーブ (Node.js 不要) |
migrate | 古いライブラリを移行 |
dashboard | 分析ダッシュボードを起動 |
mcp | MCP server を開始 |
search QUERY | フルテキスト検索または --semantic 検索 |
ask QUESTION | ナレッジベースに対する Q&A |
insights | AI 生成のインサイト |
possible | あなたのテーマから AI が作るアイデアロードマップ生成 |
skill | エージェント向け slash command スキルのインストール / 表示 |
viz | ナレッジベース向けターミナルダッシュボード |
run | ワンコマンドパイプライン: fetch → process → index |
reset | 設定と状態を削除、ユーザーデータは保持 |
export | ナレッジベースを zip バックアップにエクスポート |
import-pocket | Pocket の JSON エクスポートからブックマークをインポート |
ワンコマンドパイプラインはサイクル全体をエンドツーエンドで実行します:
geneziz run # fetch → process (AI) → index
geneziz run --no-ai # AI なしの決定的な整理のみ
AI プロバイダー
Geneziz はエンリッチ用に 4 つの AI モードに対応しています:
| モード | 使用するもの | 必要なキー | クレジット |
|---|---|---|---|
| Proxy (デフォルト) | Geneziz AI プロキシ | なし | はい (操作ごとに異なる) |
| Anthropic | Anthropic | プロバイダーキー | いいえ |
| OpenAI-compatible | OpenAI / OpenRouter / GLM / 等 | プロバイダーキー | いいえ |
| Ollama | ローカルモデル | なし | いいえ |
独自キー (BYOK) を持ち込めば、クレジット消費なしの無制限処理が可能です。 デフォルトの proxy では、クレジットの使用量は操作ごとに異なり、同梱残高から消費されます。実行前に必ず正確な料金が表示されます。
ライセンスとクレジット
Geneziz は $99 の一回払いです - サブスクリプションは一切ありません。
- ライセンス ($99 一回払い): デスクトップアプリ + CLI + MCP server + semantic search、100ボーナスAIクレジットでスタート、最大 3 デバイス
- クレジット追加パック:
$12.99(100) ·$24.99(250) ·$44.99(500) ·$79.99(1,000) - 独自の AI プロバイダーキーを持ち込めば、クレジットを完全にスキップできます
最新の料金は /landing#pricing をご覧ください。
検索
Geneziz ではナレッジベースを 2 つの方法で検索できます - どちらもローカルかつオフラインで実行されます。
- フルテキスト検索 - ランキング付きの高速キーワードマッチ
- セマンティック検索 - 単なる完全一致ではなく、意味でアイテムを発見
geneziz search "react performance" # キーワード
geneziz search "rust async runtime" --semantic # 意味ベース
あなたのデータ
すべてはYAML frontmatter 付きの Markdown として、あなたのマシン上に直接保存されます。これらはあなたが所有するプレーンなファイルです - どんなエディターでも開き、grep で検索し、git で追跡できます。
| パス | 内容 |
|---|---|
bookmarks.md | 時系列のブックマーク、新しいもの順 |
knowledge/tools/*.md | ツール / リポジトリごとに 1 ファイル |
knowledge/articles/*.md | 記事ごとに 1 ファイル |
knowledge/media/ | ダウンロードされた画像とメディア |
ファイルの正確な形式とツールファイルの例は、vault(英語)を参照してください。
MCP server
Model Context Protocol (MCP) server は、あなたのナレッジベースを MCP 対応のあらゆる AI アシスタントに公開します。ローカルファイルを直接読み取るため、データはあなたのマシンから一切外に出ません。
よく使うツール:
| ツール | 機能 |
|---|---|
search_fulltext | 高速な BM25 キーワード検索(名前・エラー・タイトルの一致) |
search_knowledge | キーワード + セマンティックのハイブリッド検索(概念) |
get_tool / get_article | スラッグで全文を取得 |
find_related | 信頼できるファイルの近傍項目を取得 |
list_tools / list_articles | フィルタ付き・ページング付きの一覧 |
get_recent / list_tags / list_domains | ナレッジベースの把握 |
save_url / add_note | アシスタントからリンクの保存とノート作成 |
どのツールをどの順番で使うかの完全なガイドは Geneziz MCP サーバーを最大限に活用する(英語)を参照してください。
セットアップ
ワンコマンドの方法: geneziz mcp register は、マシン上で検出されたすべての AI クライアント (Claude Desktop、Claude Code、Cursor、Windsurf、Codex、VS Code、ZCode、OpenCode) にサーバーエントリを書き込みます:
geneziz mcp register
各クライアントには、Geneziz 実行ファイルへの絶対パスと mcp 引数、そしてデータディレクトリを指す GENEZIZ_DATA_DIR 環境変数を含む geneziz エントリが書き込まれるため、PATH の設定は不要です。登録は Geneziz 自身のエントリだけを更新し (同じファイル内の他のサーバー定義は変更されず、最初の変更の前に 1 回だけバックアップが作成されます)、いつでも簡単に取り消せます:
geneziz mcp register --status # クライアントごとの登録状態を JSON で出力
geneziz mcp register --remove --all # Geneziz のエントリのみ削除
デスクトップアプリでも、インストール時と初回起動時に同じ登録が自動で実行されます (デフォルトで有効。設定からオフにできます)。
手動で設定したい場合は、geneziz mcp コマンドの stdio MCP server として AI アシスタントに登録します。Claude Code の場合は ~/.claude/settings.json に追加します:
{
"mcpServers": {
"geneziz": {
"command": "geneziz",
"args": ["mcp"],
"type": "stdio"
}
}
}
Cursor と Windsurf は、それぞれの MCP 設定 UI から同じサーバー定義を受け付けます。
新しいセッションで、あなたの保存に関わる質問をしてみてください:
Rust の async 向けにどんなツールをブックマークしましたか?
アシスタントはあなたのローカルナレッジベースを検索し、タイトル・カテゴリ・スニペットを含めて回答します。完全な手順は Setting up the Geneziz MCP server with Claude Code をご覧ください。
FAQ
データは本当にローカルですか? はい。すべてはあなたのマシン上のプレーンな Markdown として存在し、オフラインで動作し、grep 可能で、git で追跡できます。
サブスクリプションはありますか? いいえ。Geneziz は $99 の一回払い購入です。
オープンソースですか? Geneziz はプロプライエタリ(独自ソフトウェア)です。データ形式は 100% オープンです - プレーンな Markdown と YAML。
Mac と Windows で動きますか? はい。Geneziz は macOS と Windows 向けネイティブデスクトップアプリとして提供されます。
サービスが終了したらどうなりますか? ファイルは引き続きあなたのものです。クラウドへの依存はありません - Geneziz の実行の有無に関わらず、すべてのファイルはどのエディターでも読み続けられます。
サポート
ご質問、バグ、フィードバック: support@geneziz.app。製品の詳細と料金は /landing をご覧ください。