🗞 Claude Code의 데일리 도스

Claude Code로 하는 모든 작업을 위한 지역 신문 스타일 메모리 시스템. 어떤 것도 여러분의 컴퓨터를 떠나지 않습니다.

• 모든 저장소에 걸친 모든 Claude Code 세션, 프롬프트, 도구 호출, 파일 편집을 담는 영구 SQLite 데이터베이스

• http://localhost:3000의 신문 UI — 라이트/다크 웜 테마, 날짜 탐색, 타임라인, TODO 데스크, 통계, 검색 지원

• 일급 TODO — UI에서 편집 가능하고 로컬 MCP 서버를 통해 Claude가 조작 가능

• 글로벌 Claude Code 훅(SessionStart, UserPromptSubmit, PostToolUse, Stop, PreCompact, SessionEnd) — 기존 ~/.claude/settings.json에 추가 방식으로 병합(덮어쓰지 않으며 항상 백업)

• 모든 쓰기 전에 일반적인 비밀 형식 마스킹

• 클라우드 없음, API 키 없음, 외부 LLM 호출 없음

설치

옵션 1 — 원라인 설치 프로그램(권장)

curl -fsSL https://raw.githubusercontent.com/iamdevnitesh/daily-dose-of-claude-code/main/install.sh | bash

또는 이미 이 저장소를 클론했다면:

./install.sh

~/daily-dose-of-claude-code에 클론하고, 의존성을 설치하고, 훅/MCP를 빌드하고, ~/.claude/settings.json에 병합(먼저 백업)하고, ~/.claude/CLAUDE.md에 작은 관리 섹션을 추가한 다음 doctor를 실행합니다.

옵션 2 — npm

게시되면 누구나 전역으로 설치할 수 있습니다:

npm install -g daily-dose-of-claude-code
daily-dose install
daily-dose dev              # UI on http://localhost:3000

또는 설치 없이 실행:

npx daily-dose-of-claude-code install

옵션 3 — Docker Compose(UI 전용)

훅과 MCP 서버는 호스트에서 실행되어야 합니다 — Claude Code가 이를 하위 프로세스로 생성하며 컨테이너 안으로 접근할 수 없습니다. Docker는 볼륨 마운트를 통해 공유 SQLite 데이터베이스를 읽고/쓰는 신문 UI 전용으로 유용합니다.

# 1. Install hooks + MCP on the host first (any of the options above)
npx daily-dose-of-claude-code install

# 2. Run the UI in Docker
docker compose up -d
# → http://localhost:3000

compose 파일은 ~/.daily-dose-claude(또는 $DAILY_DOSE_HOME)를 컨테이너의 /data에 마운트하므로, UI는 호스트 측 훅과 MCP 서버가 쓰는 것과 정확히 동일한 데이터베이스를 공유합니다. 언제든 컨테이너를 종료해도 됩니다 — 캡처는 호스트에 있으므로 계속 실행됩니다.

옵션 4 — 수동(개발자 / 해킹 가능)

git clone <repo> && cd daily-dose-of-claude-code
npm install
npm run build:node          # compile hooks + MCP
npm run install:daily-dose  # merge into ~/.claude/settings.json (backup first)
npm run doctor
npm run dev                 # http://localhost:3000

Related MCP server: Longhand

daily-dose CLI

전역으로 설치하면(또는 npx로) daily-dose 명령이 모든 것을 처리합니다:

파일 위치

아키텍처

Claude Code
  │
  ├─ Hooks (host-side Node): SessionStart, UserPromptSubmit,
  │                          PostToolUse, Stop, PreCompact, SessionEnd
  │                          → write to SQLite
  │
  └─ MCP server (host-side stdio, daily-dose)
                          → same SQLite DB

     Next.js UI (host or Docker, localhost:3000)
                          → same SQLite DB

활동 캡처에 UI가 실행 중일 필요는 없습니다 — 훅이 SQLite에 직접 통신합니다. Docker를 종료하고, next dev를 종료하고, UI를 제거해도 — Claude 활동은 계속 로컬 데이터베이스에 기록됩니다.

MCP 도구

• daily_dose_add_todo

• daily_dose_list_todos

• daily_dose_update_todo

• daily_dose_complete_todo(title_query 또는 id 허용)

• daily_dose_delete_todo

• daily_dose_search_memory(활동 + TODO에 대한 FTS5)

• daily_dose_get_day

• daily_dose_get_recent_activity

• daily_dose_remember

테스트

npm test

테스트는 임시 DAILY_DOSE_HOME에 대해 실행됩니다 — 실제 데이터베이스와 Claude 구성은 절대 건드리지 않습니다.

참고 사항 및 비목표

• 외부 AI 호출 없음 — 제목/요약은 결정적(deterministic)입니다

• 전체 도구 출력(예: 거대한 Read 페이로드)은 절대 저장되지 않으며 간결한 메타데이터만 저장됩니다

• 모든 쓰기에 마스킹이 적용됩니다; 그래도 의도적으로 비밀을 붙여넣지 마세요

• 훅은 fail-open입니다 — Daily Dose 실패가 Claude Code를 절대 차단하지 않습니다

• Docker는 설계상 UI 전용입니다; 훅은 Claude Code가 생성할 수 있도록 호스트에 있어야 합니다