소개
devlog은 Git 저장소 내에서 구조화된 세션 저널을 작성하는 CLI/TUI 도구입니다. 개발 작업 중 컨텍스트, 노트, 블로커, 인수인계 정보를 기록하여 파트너(인간 또는 AI)가 정확하게 작업을 이어받을 수 있도록 돕습니다. 모든 기록은 외부 서비스나 계정 없이 로컬 Git 레포에 평문 마크다운 파일로 저장됩니다.
상세정보
Windows (PowerShell – 권장)
다음 명령을 PowerShell에서 실행하면 최신 릴리스가 다운로드되어 자동 설치됩니다.
irm https://raw.githubusercontent.com/amohamma8029/devlog/main/scripts/install.ps1 | iex
설치 프로그램은 다운로드 파일을 무결성 검증 후 %LOCALAPPDATA%Programsdevlogbin 경로에 설치하고 사용자 PATH에 추가합니다.
패키지 관리자로 설치
- WinGet:
winget install amohamma8029.devlog - Chocolatey:
choco install devlog - Scoop:
scoop bucket add amohamma8029 https://github.com/amohamma8029/scoop-bucket후scoop install devlog
수동 설치
GitHub 릴리스 페이지에서 Windows용(amd64 또는 arm64) ZIP 아카이브를 다운로드하여 압축을 풀면 됩니다.
기본 사용법
설치 후 터미널에서 다음과 같은 명령으로 작업을 기록할 수 있습니다.
devlog open "인증 미들웨어 구현": 새로운 세션을 엽니다.devlog note "JWT 패키지 리팩토링 완료": 작업 메모를 추가합니다.devlog block "리프레시 토큰 로테이션 설계 결정 대기 중": 현재 막힌 작업(블로커)을 기록합니다.devlog status: 현재 세션의 전체 상황을 요약하여 보여줍니다.devlog handoff: 후속 작업자가 참고할 인수인계 문서를 생성합니다.devlog close: 현재 세션을 마감합니다.
이런 경우에 유용합니다
- 원격 개발 협업: 팀원이나 AI 코딩 파트너와 코드를 함께 작업할 때, 그날의 진행 상황과 막힌 문제를 명확히 공유해야 할 때 유용합니다.
- 장기 프로젝트 컨텍스트 유지: 여러 날에 걸쳐 작업하는 기능을 개발할 때, 앞선 세션에서 했던 결정과 현재 상태를 Git 레포 안에서 정리해두면 다시 작업을 시작할 때 시간을 절약할 수 있습니다.
- 작업 이력 관리: 외부 일정 관리 도구 없이 Git 커밋과 연동되는 형식으로 개인 또는 팀의 개발 작업 일지를 관리하고 싶을 때 적합합니다.
지원 환경
Windows, macOS, Linux에서 사용할 수 있습니다. Windows에서는 PowerShell 설치 스크립트를 통해 가장 쉽게 설치할 수 있으며, WinGet, Chocolatey, Scoop과 같은 주요 패키지 관리자도 지원합니다.
최신 버전
제공된 정보 기준 패키지 버전은 1.0.0입니다. 최신 릴리스는 공식 GitHub 저장소의 릴리스 페이지에서 확인할 수 있습니다.
화면으로 보는 주요 기능
devlog 로고 화면

파란색 배경 위에 흰색 글씨로 '[devlog]'이라는 텍스트가 중앙에 위치해 있다.
시스템 요구사항
Windows에서 사용 시 PowerShell이 필요할 수 있습니다.


