Dear User

AIエージェントはあなたのために働いていますが、あなたとエージェントはどれくらい上手く連携できていますか？

Dear Userは、Claude Codeのセットアップを監査し、修正すべき点を正確に指摘するオープンソースツールです。コラボレーションのスコア化、漏洩したシークレットや設定の競合の検出、システム健全性のチェックをすべてローカルで行います。Wrappedカードを明示的に共有しない限り、データがアップロードされることはありません。

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

その後、Claudeにこう尋ねてください: "Analyze my collaboration with Claude" (Claudeとの連携を分析して)

ランディングページ: dearuser.ai · フィードバック: Claude内の feedback ツールを使用するか、issue を作成してください。

機能

Dear Userは MCPサーバー (Model Context Protocol — Claude CodeやClaude Desktopが使用するプラグインシステム) です。インストールすると、エージェントが呼び出せるツールセットとして表示されます。GUIやサインアップ、クラウドのアカウントは不要です。

3つのローカルレポート、1つの共有可能なWrappedカード、1つのフィードバックチャネルを提供します：

その他、ヘルパー機能：onboard (7ステップのガイド付きセットアップ)、history (再スキャンなしでのトレンド表示)、help (メニュー)、implement_recommendation、dismiss_recommendation、share_report (Wrapped専用アップロード)。

ローンチのハイライト

• 共有可能なWrapped — wrapped を実行し、share_report を実行すると、統計カード用の dearuser.ai/r/<token> URLを取得できます。アップロード前に匿名化されます（パスはベース名に短縮、メールアドレスは削除、シークレットは編集済み）。コラボレーション/セキュリティ/ヘルスレポートはローカルに留まります。これらには自動共有に適さないビジネスコンテキストが含まれる可能性があるためです。

• 12カテゴリのシークレットスキャナー — OpenAI、Anthropic、GitHub、AWS、Stripe、Slack、Google、Supabase、Vercel、秘密鍵、汎用環境シークレット、ベアラートークン。CLAUDE.md / AGENTS.md、メモリファイル、スキル、フックをスキャンします。

• AGENTS.mdのネイティブサポート — CLAUDE.mdと並ぶファーストクラスの入力としてサポート。Cursor、Codex、Aider、Cline、Zed、および Linux Foundationのクロスツール標準 に従うすべてのツールでそのまま動作します。同じディレクトリに両方のファイルがある場合はマージされます。

• 意味的な競合検出 (新規) — キーワードが共通していなくても、ルール同士が矛盾している箇所を見つけます。「頻繁にコミットする」と「コミット前に確認する」といった矛盾をフラグ立てします。

• 現実に基づいたスコアの調整 — 2つの調査を実施：substrateがコミットされた988件の公開Claude Codeセットアップ（中央値32/100、最大63）と、2,895件のスタンドアロンCLAUDE.mdファイル（中央値18、最大60）。substrateコーパスは、ライブスコアの比較基準となります。両方の調査については research/calibration/ を参照してください。

インストール

クライアントごとに1つのコマンドを実行します。完全なガイド: docs/install.md。

Claude Code (CLI)

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

その後、ツールを表示させるためにClaude Codeを再起動してください。

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に追加します：

{
  "mcpServers": {
    "dearuser": {
      "command": "npx",
      "args": ["@poisedhq/dearuser-mcp"]
    }
  }
}

Cursor, Windsurf, Cline, Zed — docs/install.md を参照してください。

オプション：スラッシュコマンドをインストールすると（全リストは Commands を参照）、プロンプトで尋ねる代わりに /dearuser-collab のように入力できます：

npx -p @poisedhq/dearuser-mcp dearuser-install-skills

最初の5分間

インストール後、クライアントを再起動し、以下の順序で試してください：

1. ベースラインスキャン:

   Run Dear User collab on this project

   ペルソナ（Vibe Coder / Senior Developer / Indie Hacker / Venture Studio / Team Lead）、7つのカテゴリにわたる0-100のスコア、および3-10の具体的な推奨事項が表示されます。

2. セキュリティスキャン:

   Run Dear User security

   エージェント契約（CLAUDE.mdまたはAGENTS.md）、メモリ、スキル、フックをチェックし、漏洩したトークン、インジェクションの表面、ルールの競合がないか確認します。

3. 結果の共有 (オプション):

   Share my collab report

   dearuser.ai/r/<token> リンクを返します。アップロード前に匿名化されます。どこかに貼り付けるかどうかはあなた次第です。

collab の出力例:

Persona: Indie Hacker (87% confidence)
Score:   73 / 100

Top friction:
  • Quality Standards — no test-before-commit rule in CLAUDE.md
  • Memory Health    — 2 memory files haven't been touched in 90+ days
  • Communication    — no language preference stated (English vs Danish mixing)

Recommendations (3 shown, 5 total):
  1. Add a "Session start protocol" block to CLAUDE.md  (apply with: implement_recommendation)
  2. Rotate the OpenAI key leaked in ~/.claude/memory/api-notes.md
  3. Merge overlapping skills: deploy-check and ship-check share 80% of their rules

コマンド

Dear Userには8つのスラッシュコマンドが付属しています。エージェントに名前で尋ねるか、dearuser-install-skills でインストールした場合はスラッシュコマンドを入力してください。

エージェントがあなたのために呼び出せる3つのチャット内アクション：share_report (Wrappedカードを dearuser.ai/r/<token> にアップロード)、implement_recommendation (保留中の推奨事項を適用)、dismiss_recommendation (無関係としてマーク)。

プライバシー

Dear Userはローカルファーストです。スキャン結果はあなたのマシンに留まります：

• エージェント契約（CLAUDE.mdまたはAGENTS.md）、メモリ、スキル、フック、セッションメタデータは読み取られますが、アップロードされることはありません

• 結果は ~/.dearuser/dearuser.db (SQLite, WALモード) に保存されます

• オプションのローカルホストダッシュボードはそのDBから読み取ります — 外部へ送信されるものはありません

• Dear Userはセッションのメタデータのみ（カウント、長さ）を読み取ります — 実際の会話内容は読み取りません

• APIキーは不要、サインアップ不要、テレメトリなし

唯一の例外は、あなたが明示的にトリガーしたものです：

• share_report (Wrappedのみ) — Wrappedカードは匿名化され（パスは短縮、メールアドレスは削除、シークレットパターンに一致するものは編集）、dearuser.ai にアップロードされるため、URLを共有できます。ローカルDBは変更されません。expires_at を設定してリンクを自動期限切れにすることも可能です。コラボレーション/セキュリティ/ヘルスレポートは共有できません。これらには公開URLに置くべきではないビジネスコンテキスト（プロジェクト名、クライアント名、アーキテクチャのメモ）が含まれる可能性があるためです。

• feedback — フィードバックツールを呼び出すと、メッセージはSupabaseの受信箱に送信されます。それがこのツールの目的です。スキャン結果やファイルは添付されず、あなたが書いたテキストのみが送信されます。

他のツールが何かを送信することはありません。share_report が DEARUSER_SUPABASE_URL + DEARUSER_SUPABASE_SERVICE_KEY で設定されていない場合、エラーが適切に処理され、Dear Userの他の機能は動作し続けます。

プライバシーの詳細: docs/privacy.md。

仕組み

Your files (CLAUDE.md or AGENTS.md, memory, hooks, skills, sessions)
        │
    Scanner ──► Parser ──► Engines (scoring, secrets, conflicts, health)
        │
 Persona detection → Scoring → Gap analysis → Recommendations
        │
    Feedback loop (tracks which recommendations you implemented)
        │
    ~/.dearuser/dearuser.db  ←  dashboard reads from here

• セットアップから5つのペルソナを検出 — それぞれに合わせた推奨事項を提供

• 7つのスコアリングカテゴリ：役割の明確さ、コミュニケーション、自律性のバランス、品質基準、メモリの健全性、システムの成熟度、カバレッジ

• フィードバックループ：Dear Userは推奨した内容を記憶します。次回実行時に、どれを実装したかを確認し、スコアの差分を表示します。

対象ユーザー

• 「Vibe coders」 — Claudeにプロンプトを投げてプロダクトを出荷しているが、セットアップが実際に機能しているか確信が持てない方。Dear Userが教えてくれます。

• シニア開発者 — カスタムのlintパイプラインを構築することなく、漏洩したシークレット、設定のドリフト、ルールの競合を迅速に監査したい方。

• インディーズハッカー / ソロ創業者 — プロジェクト全体でフック、スキル、メモリが蓄積されている方。Dear Userが孤立しているものや矛盾しているものを表面化させます。

• チームリーダー — チームの共有エージェントセットアップをローカルで監査したい方。コラボレーション、セキュリティ、ヘルスレポートはマシン内に留まり、個人のWrappedカードのみを公開共有できます。

リポジトリ構成

• mcp/ — @poisedhq/dearuser-mcp npmパッケージ (MCPサーバー)。開発メモは mcp/README.md を参照。

• web/ — dearuser.ai ランディングページ + 共有レポートページ (Astro)。

• docs/ — インストールガイド、プライバシー文書、プラットフォームごとのセットアップ (オプションの security プラットフォームアドバイザー用のSupabase/GitHub/Vercel設定)。

• research/ — 共有可能なキャリブレーションデータ + アーキテクチャメモ。

貢献

CONTRIBUTING.md を参照してください。バグ報告や小さな修正はGitHubのissueやPRで歓迎します。

コミュニティとサポート

• GitHub Discussions — 質問、アイデア、「やり方」、ショー＆テル

• GitHub Issues — 再現可能なバグや機能リクエスト

• Feedback inbox — プライベートなメモ、またはClaude内から feedback MCPツールを使用

リンク

• dearuser.ai — ランディングページ

• インストールガイド · プライバシー · プラットフォームアドバイザーのセットアップ

ライセンス

Dear UserはMITライセンスです。LICENSE を参照してください。

オープンコアのコミットメント: このリポジトリ内のすべてはMITであり、今後もMITであり続けます。チーム機能やホスト型機能（エージェンシーダッシュボード、プロジェクト横断のトレンドライン、業界特有のベンチマークなど）を構築する場合でも、それらは別のリポジトリで独自のライセンスの下で提供され、このリポジトリから機能を抜き出すことはありません。