X Knowledge Agent

テーマ

設定 ​

X Knowledge Agent の各種設定方法を説明します。

環境変数 ​

DATABASE_URL のみが必須です。その他はオプションです。

変数名必須説明デフォルト
DATABASE_URLYesSQLite データベースパスfile:./prisma/dev.db
JWT_SECRETNoJWT署名用シークレット自動生成
PORTNoサーバーポート3001

重要

API キーや認証情報は環境変数に直接書かないでください。OS Keychain に保存し、参照する形式を使います。

bash
# 正しい方法: .zshrc に参照を追加
export ANTHROPIC_API_KEY=$(security find-generic-password -s "ANTHROPIC_API_KEY" -a "$USER" -w)

認証情報の管理 ​

すべての認証情報は OS Keychain に保存されます。

bash
# Keychain に保存
security add-generic-password -s "KEY_NAME" -a "$USER" -w "値" -U

# Keychain から取得（コード内では不要 — 自動で参照される）
security find-generic-password -s "KEY_NAME" -a "$USER" -w

AI分類の設定 ​

Claude CLI 認証（推奨） ​

Claude Code CLI にログインしていれば、追加設定なしでAI分類が使えます。

bash
# CLI 認証の状態確認
curl http://localhost:3001/api/settings/cli-status

カテゴリのカスタマイズ ​

lib/categorizer.ts の DEFAULT_CATEGORIES を編集してカテゴリを追加・変更できます。各カテゴリの description がそのまま Claude への分類指示として使われます。

Obsidian エクスポート設定 ​

エクスポート先の Obsidian Vault パスを設定します:

bash
# 設定画面から、または直接 Setting テーブルに保存
# key: obsidian_vault_path
# value: /path/to/your/obsidian/vault

エクスポート形式 ​

Vault/
  Bookmarks/
    {Category}/
      {author} - {text} ({tweetId}).md
    {Category}.md  ← MOC (Map of Content)

各ノートには YAML frontmatter が付与されます:

yaml
---
tags: [ai, llm, agent]
categories: [AI-Tools]
author: "@username"
tweetId: "1234567890"
url: "https://x.com/username/status/1234567890"
date: 2025-01-15
---

Cloudflare Tunnel（リモートアクセス） ​

bash
# Tunnel の開始
bash scripts/start-shared.sh

# カスタムドメインで公開される
# https://xbookmark.your-domain.com

定期実行の設定 ​

macOS (launchd) ​

scripts/setup.sh が自動で ~/Library/LaunchAgents/ に plist を配置します。手動で変更する場合:

bash
# 状態確認
launchctl list | grep xbookmark

# 無効化
launchctl unload ~/Library/LaunchAgents/com.xbookmark.daily-sync.plist

Linux (systemd) ​

bash
# タイマーの状態確認
systemctl --user status xbookmark-sync.timer

# 手動実行
systemctl --user start xbookmark-sync.service