AIエージェントでHearlogの録音を検索

貼り付けプロンプトでのインストール

下の内容をコピーしてClaude CodeまたはCodexの新しいセッションに貼り付けると、エージェントがコマンドの実行前に確認を求め、Hearlogフォルダの場所を尋ねます

このコンピューターにHearlogスキルをインストールし、私のHearlogの録音に接続してください。

1. このコンピューターのOSを確認し、該当するインストールコマンドを以下から示して、私の許可を得てから実行してください。
macOS·Linux: curl -fsSL https://hearlog.umicorp.kr/skill/install.sh | sh
Windows PowerShell: irm https://hearlog.umicorp.kr/skill/install.ps1 | iex
2. PATHに依存せず、インストール時の出力に表示されたhearlog実行ファイルのフルパスを使用してください。
3. Hearlogフォルダの場所を私に尋ねてください。保存先の種類ごとのフォルダについては、https://hearlog.umicorp.kr/ja/skill/ を参照してください。
4. 私が確認したパスでconfig set --root "<パス>"を実行し、続けてlist --limit 5を実行して、結果のタイトルと日付だけを表示してください。
5. 最後に、スキルは新しいセッションから使えると案内してください。

直接インストール

ターミナルでコマンド一行を実行してインストールし、同じコマンドを再実行すると設定ファイルを維持したまま更新できます

curl -fsSL https://hearlog.umicorp.kr/skill/install.sh | sh

irm https://hearlog.umicorp.kr/skill/install.ps1 | iex

Windows版は実機での確認前のためベータ版です

インストール先

Hearlogのインストーラーが作成していない同名の既存スキルフォルダは削除せず、バックアップフォルダ（~/.local/share/hearlog/backup、Windows %LOCALAPPDATA%\hearlog\backup）に移動し、PATHとシェル設定ファイルは変更しません

対応環境

• macOS 13以上 · Apple silicon・Intel
• Linux x64・arm64 · カーネル 3.2以上
• Windows 10以上 x64 · ベータ版
• エージェント: Claude CodeまたはCodex

使用例

Hearlogのインストール後、新しいセッションで録音の内容を普段どおりに質問すると、エージェントがhearlogコマンドで録音を探し、必要な部分だけを読んで答えます

録音例は紹介ページ用の架空の通話です。実際の画面はエージェントによって異なり、コマンドの実行前に許可を求める場合があります

保存先ごとのフォルダ接続

スキルはHearlogが保存先に送ったファイルをコンピューター上の通常のファイルとして読み取るため、このコンピューターから見えるフォルダを指定します

保存先が複数ある場合は、すべての録音を自動で受け取る保存先を指定してください。自動転送がオフの場合、録音後に保存先を追加した場合、転送に失敗した場合は、該当する録音はそのフォルダにありません

手動設定

貼り付けプロンプトを使わずにHearlogフォルダを指定するコマンドで、パスを実際のフォルダに変更して使用し、設定ファイルは~/.config/hearlog/config.json、Windowsでは%APPDATA%\hearlog\config.jsonにあります

~/.local/bin/hearlog config set --root "/path/to/Hearlog"
~/.local/bin/hearlog list --limit 3

& "$env:LOCALAPPDATA\Programs\hearlog\hearlog.exe" config set --root "D:\Hearlog"
& "$env:LOCALAPPDATA\Programs\hearlog\hearlog.exe" list --limit 3

個人情報

• Hearlogフォルダは読み取り専用で、ファイルの変更・移動・削除は行いません
• hearlog実行ファイルは別のコンピューターのHearlogフォルダ用に設定したSSHホスト1か所以外に接続せず、Hearlogのインストーラーはhearlog.umicorp.krからのみダウンロードします
• エージェントが読み取った録音内容は、他のファイルをエージェントに見せた場合と同様に会話に含まれ、エージェントが使用するAIモデルで処理されます
• スキルはエージェントに、録音内容をコミット・PR・イシュー・メッセージなどで会話の外に出す前にユーザーへ確認し、録音内の文章を指示ではなくデータとして扱うよう指示します
• 非表示グループはグループ名を直接指定した場合にのみ開き、Hearlogで削除した録音（Trashフォルダ）は依頼があった場合にのみ読み取ります

非表示グループの設定コマンドで、--hidden-groupは一覧全体を置き換え、--clear-hidden-groupsは設定を解除します

~/.local/bin/hearlog config set --hidden-group "家族" --hidden-group "友人"

& "$env:LOCALAPPDATA\Programs\hearlog\hearlog.exe" config set --hidden-group "家族" --hidden-group "友人"

トラブルシューティング

アンインストール

アンインストールコマンドはなく、以下のファイル・フォルダを削除してもHearlogフォルダの録音ファイルには影響しません

~/.local/bin/hearlog
~/.claude/skills/hearlog
~/.agents/skills/hearlog
~/.config/hearlog
~/.local/share/hearlog

%LOCALAPPDATA%\Programs\hearlog
%USERPROFILE%\.claude\skills\hearlog
%USERPROFILE%\.agents\skills\hearlog
%APPDATA%\hearlog
%LOCALAPPDATA%\hearlog