Pulse
Claude Code를 사용한 작업에 대한 메모리 레이어입니다. 모든 세션을 조용히 기록하여, 사용자 본인이 소유하는 지식 기반으로 변환합니다.
Six months of Claude Code sessions, captured by Pulse and turned into a linked vault of daily and project notes
모든 세션이 연결된 노트가 됩니다. 몇 달에 걸쳐 사용자가 구축해 온 것들의 연결된 지도를 만들어내며, 이는 Obsidian 그래프로 표시됩니다.
일주일 동안 개발을 마치면 대부분의 내용이 사라집니다. 화요일에 무엇을 배포했지? 왜 그 기능을 통째로 다시 만들었지? 이런 질문들은 더 이상 스크롤할 일이 없는 오래된 채팅 기록 속에 묻혀 있습니다.
Pulse가 이 문제를 해결합니다. Pulse는 모든 Claude Code 세션을 사용자가 소유하는 데이터베이스에 기록하며, 매일 밤 프로젝트별로 그날의 활동을 정리하여 Obsidian에서 열 준비가 된 형태로 작성해 줍니다. 몇 달이 지난 후에도 여전히 의미가 통하도록, 마치 사용자가 일기를 쓰듯이 명료하고 깔끔하게 내용을 작성합니다. 당신의 작업물이 사라지는 것을 막아줍니다.
사용자의 데이터는 본인이 소유한 Convex 배포(무료 티어)와 노트 저장소에 존재합니다. Pulse 서버도 없고, 저희를 통해 생성해야 하는 계정도 없습니다. 무엇이 기록되고 어떻게 보호되는지에 대해서는 SECURITY.md를 참조하십시오.
하루의 모습은 다음과 같습니다:
---
date: "2026-06-02"
tags: [pulse, daily]
...
일기장 그 이상
Pulse는 작은 기능들로 구성되었습니다. 가장 먼저 도입된 것은 데일리 노트(daily note)입니다. 이 노트는 사용자의 하루를 읽고 마치 사용자가 직접 쓰듯이 작성해 줍니다.
다른 모든 기능들은 이 노트를 읽어오는 방식으로 작동합니다. 현재 작동하는 기능들은 다음과 같습니다:
- 무엇을 완료했는지에 대한 주간 요약(weekly recap).
- 결정 사항, 버그, 규칙 및 미결 항목들을 수집하고 해당 프로젝트에서 작업한 모든 날짜를 연결해 주는 프로젝트별 페이지(page per project).
- 회상(Recall):
당신의 Claude Code 작업 $\rightarrow$ Pulse가 포착하고 $\rightarrow$ 사용자 본인의 데이터베이스
|
매일 밤
...
- 사용자가 작업하는 동안 모든 Claude Code 세션을 자동으로 포착합니다. 손댈 필요가 없습니다.
- 매일 밤 프로젝트별로 명확한 일지 하나를 평이한 영어(plain English)로 작성하여 몇 달 후에도 의미가 통하도록 합니다.
- 사용자의 노트는 사용자 소유입니다. 읽기, 검색, 재사용이 쉬운 개인 폴더 내의 평이한 파일 형식입니다.
이 저장소에 포함된 내용 (What is in this repo)
backend/ 세션을 저장하는 Convex 백엔드
skills/
setup/ 설치 스크립트와 캡처 후크
...
요구 사항 (Requirements)
- Claude Code
- Python 3.9 이상 버전 (pip 설치할 필요 없음)
- Node.js 20 이상 버전 (Convex CLI용)
- 무료 Convex 계정
- 노트용 git 저장소 (어떤 GitHub 저장소든 사용 가능하며, Obsidian에서 열 수도 있습니다)
설정 방법 (Setup)
저장소를 클론하고 Claude에게 설정을 요청하세요:
git clone https://github.com/muhammademanaftab/pulse.git
cd pulse
그런 다음, Claude Code에서 **"set up pulse"**라고 말합니다. Claude가 runbook(skills/setup/SKILL.md)을 따라 세 단계를 안내합니다:
- 캡처 (Capture): Convex 백엔드를 배포하고, 자격 증명을 저장하며, 후크를 연결합니다. Claude가 요청할 때 브라우저에서 한 번 로그인하면 됩니다.
- 일일 노트 (Daily notes): Claude에게 노트가 위치할 곳을 물어봅니다(예:
~/pulse-notes를 생성하거나 사용자가 지정한 경로를 사용할 수 있습니다). 설정 파일을 작성해주고, 첫 번째 노트를 보여주며, /pulse-recall을 설치합니다.
- 야간 루틴 (Nightly routine) (선택 사항): Claude가 클라우드 루틴 과정을 안내하여 노트가 매일 밤 자동으로 쌓이게 합니다.
만약 수동으로 구성하려는 경우:
python3 skills/setup/install.py # 캡처
python3 skills/setup/install.py notes --repo ~/pulse-notes --create # 노트 설정
python3 skills/setup/install.py recall # /pulse-recall
설정 후에는 캡처(capture)가 활성화되며 모든 세션이 기록됩니다.
노트 저장 위치
다이제스트는 이 곳이 아닌 사용자의 노트 레포지토리(notes repo)에 작성합니다:
<your-notes-repo>/
|- Pulse/
|- Daily/
...
나이틀리 다이제스트(nightly digest), 위클리 신스(weekly synth), 그리고 주간 포스트 초안은 모두 claude.ai 루틴으로 실행되며, 사용자의 컴퓨터가 꺼져 있어도 작동합니다. 루틴과 정확히 채워야 할 필드는 routines/를 참조하세요.
설정 (Configuration)
Setup은 사용자를 위해 ~/.pulse/config.yaml을 config.example.yaml로부터 작성합니다. 변경하려면 이 파일을 편집하세요:
| 키 (Key) | 의미 (Meaning) |
|---|
timezone | 사용자의 시간대이며, 하루의 작업을 그룹화하는 데 사용됩니다. |
| ... | |
덜 일반적인 키들(Less common keys)은 각각 합리적인 기본값(sensible default)을 가지고 있습니다: weekly_hub_prefix, weekly_index, posts_hub_prefix, posts_index, 그리고 project_labels (레이블 맵의 경로).
Setup은 또한 ~/.pulse/project-labels.yaml을 작성합니다. 이 파일을 사용하여 노트에서 폴더에 더 보기 좋은 프로젝트 이름(my-app-backend: My App)을 부여하고, 해당 세션의 실제 프로젝트로 계산되어야 하는 임시(scratch) 폴더들(tmp, scratch...) 목록을 지정할 수 있습니다.
상태 (Status)
Pulse는 초기 단계(0.x)입니다. 현재 캡처, 일일 노트(daily note), 프로젝트 페이지, 주간 요약(weekly recap), 리콜(recall), 포스트 초안은 작동합니다. 개발 로그(devlog)와 자랑 문서(brag document)는 계획되었으나 아직 구축되지 않았습니다. 1.0 버전까지는 불안정한 부분과 호환성 문제가 발생할 수 있음을 예상하세요.
라이선스 (License)
MIT.