本文へスキップ
ドキュメント一覧
Docs

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 は接続済みのソースとアカウントをループします:

bash
geneziz fetch --source github          # アクティブな GitHub アカウントすべて
geneziz fetch --source github --account gh-work   # 1 つだけ

GitHub のスター

スターをつけたリポジトリを同期します。各リポジトリはカテゴリ分けされ、Markdown のナレッジファイルとして整理されます。

bash
geneziz sync

Pocket

Pocket の JSON エクスポートをインポートします。Pocket の web UI からライブラリをエクスポートして、次に:

bash
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閲覧 + 検索インデックスを再構築
webweb ビューアーの開発サーバーを起動
buildweb ビューアーを本番用にビルド
serveビルド済みビューアーをサーブ (Node.js 不要)
migrate古いライブラリを移行
dashboard分析ダッシュボードを起動
mcpMCP server を開始
search QUERYフルテキスト検索または --semantic 検索
ask QUESTIONナレッジベースに対する Q&A
insightsAI 生成のインサイト
possibleあなたのテーマから AI が作るアイデアロードマップ生成
skillエージェント向け slash command スキルのインストール / 表示
vizナレッジベース向けターミナルダッシュボード
runワンコマンドパイプライン: fetch → process → index
reset設定と状態を削除、ユーザーデータは保持
exportナレッジベースを zip バックアップにエクスポート
import-pocketPocket の JSON エクスポートからブックマークをインポート

ワンコマンドパイプラインはサイクル全体をエンドツーエンドで実行します:

bash
geneziz run             # fetch → process (AI) → index
geneziz run --no-ai     # AI なしの決定的な整理のみ

AI プロバイダー

Geneziz はエンリッチ用に 4 つの AI モードに対応しています:

モード使用するもの必要なキークレジット
Proxy (デフォルト)Geneziz AI プロキシなしはい (操作ごとに異なる)
AnthropicAnthropicプロバイダーキーいいえ
OpenAI-compatibleOpenAI / 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 つの方法で検索できます - どちらもローカルかつオフラインで実行されます。

  • フルテキスト検索 - ランキング付きの高速キーワードマッチ
  • セマンティック検索 - 単なる完全一致ではなく、意味でアイテムを発見
bash
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) にサーバーエントリを書き込みます:

bash
geneziz mcp register

各クライアントには、Geneziz 実行ファイルへの絶対パスと mcp 引数、そしてデータディレクトリを指す GENEZIZ_DATA_DIR 環境変数を含む geneziz エントリが書き込まれるため、PATH の設定は不要です。登録は Geneziz 自身のエントリだけを更新し (同じファイル内の他のサーバー定義は変更されず、最初の変更の前に 1 回だけバックアップが作成されます)、いつでも簡単に取り消せます:

bash
geneziz mcp register --status        # クライアントごとの登録状態を JSON で出力
geneziz mcp register --remove --all  # Geneziz のエントリのみ削除

デスクトップアプリでも、インストール時と初回起動時に同じ登録が自動で実行されます (デフォルトで有効。設定からオフにできます)。

手動で設定したい場合は、geneziz mcp コマンドの stdio MCP server として AI アシスタントに登録します。Claude Code の場合は ~/.claude/settings.json に追加します:

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 をご覧ください。

このページの内容