Claude Code 세션 로그를 자동으로 수집·구조화하여 devLog를 생성하는 CLI 도구
Claude Code로 작업하면서 쌓인 대화 로그와 git 이력을 자동으로 분석하여, 문제 → 원인 → 해결 → 결과 구조의 devLog 초안을 만들어줍니다. 사용자는 핵심 맥락만 보완하면 됩니다.
하루 종일 Claude Code와 대화하면서 일하고 나면, 퇴근할 때 "오늘 뭐 했지?" 싶을 때가 있습니다. 문제 해결 과정을 기록하고 싶은데, 일하면서 동시에 정리하긴 현실적으로 어렵고요.
그런데 생각해보면 Claude Code 대화 로그에 이미 모든 맥락이 다 담겨 있습니다. 그걸 자동으로 꺼내서 구조화해주면, 하루 5분이면 devLog를 완성할 수 있지 않을까 — 그래서 만들었습니다.
- 최근 7일 선택 — 날짜, 프로젝트, 세션을 직접 골라서 집중 구조화
- 자동 구조화 — Claude Code CLI로 태스크 단위 분리 + 초안 생성
- 적극적 질문 — 모호한 부분은 추측 대신 질문 (태스크당 최대 5개)
- 프롬프트 수정 — 초안 미리보기 후 자연어로 수정 지시 가능
- 이중 저장 — 시간순 RAW 일지 + 프로젝트별 태스크 일지
- 태스크 매칭 — 같은 작업이면 기존 파일에 자동 append (Claude가 판단)
최근 7일 중 devLog를 작성할 날짜를 선택합니다.
선택한 날짜에 작업한 프로젝트 목록이 표시됩니다.
프로젝트별 세션을 세부적으로 조정할 수 있습니다.
Claude Code가 세션 로그를 분석하여 태스크로 구조화합니다.
로그에서 확인할 수 없는 모호한 부분을 질문합니다.
npm install -g awesome-devlog- Node.js 22 이상
- Claude Code CLI 설치 및 로그인 완료 (설치 안내)
Claude Code의 기존 인증을 그대로 사용하므로 별도 API 키가 필요 없습니다.
devlog initdevLog 저장 경로를 설정합니다. 설정은 ~/.devlog/config.json에 저장됩니다.
devlog실행하면 다음 흐름으로 진행됩니다:
1. 날짜 선택 (최근 7일)
2. 프로젝트 선택
3. 세션 선택
4. Claude가 태스크로 구조화
5. 모호한 부분 질문
6. 배운 점 확인
7. 초안 미리보기 → 수정 or 저장
devlog view저장된 devLog를 GitHub 스타일 HTML로 변환하여 브라우저에서 열어줍니다. 시간순 일지 또는 프로젝트별 일지를 선택할 수 있습니다.
devlog view ~/devlog/daily/2026-04-10_1930.md # 특정 파일 바로 열기~/devlog/
├── daily/ ← 시간순 RAW 일지
│ ├── 2026-04-09_1845.md
│ └── 2026-04-10_1930.md
│
└── projects/ ← 프로젝트별 일지
├── my-project/
│ ├── CSS 호환성 이슈 수정.md ← 같은 태스크면 날짜별 append
│ └── 모바일 카드 UI 추가.md
└── awesome-devlog/
└── 날짜 선택 기능 추가.md
날짜+시각 기반 파일명으로, 상단에 메타데이터(반영 날짜, 프로젝트별 작업시간)를 포함합니다. 같은 날 여러 번 실행해도 덮어쓰지 않습니다.
프로젝트 폴더 안에 태스크 제목으로 파일이 생성됩니다. 같은 작업을 다른 날에 이어서 했다면, Claude가 판단하여 기존 파일에 날짜별로 이력이 쌓입니다.
pnpm install # 의존성 설치
pnpm dev # 개발 모드 (watch)
pnpm build # 빌드
pnpm check # 린트 + 포맷 검사
pnpm check:fix # 린트 + 포맷 자동 수정| 항목 | 선택 |
|---|---|
| 언어 | TypeScript (strict) |
| AI | Claude Code CLI (claude -p) |
| CLI | @clack/prompts |
| 빌드 | tsup |
| Linter | Biome v2 |
상세 기획은 docs/를 참고하세요.