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/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판은 실제 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 설치 프로그램은 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