LazyTrack

습관 기록

LazyTrack은 시간 기반 및 횟수 기반 습관 기록을 모두 지원합니다. 사용자는 lazytrack code 2h와 같이 시간 단위로, 또는 lazytrack water 8x와 같이 횟수 단위로 습관을 기록할 수 있습니다. 특정 시간을 지정하지 않으면 기본값인 30분이 적용됩니다.

요약 및 통계

lazytrack summary 명령을 통해 주간 활동 요약을 확인할 수 있습니다. 이 요약은 ASCII 기반 바 차트, 목표 대비 달성률, 연속 일수(스트릭)를 보여줍니다. --daily 플래그를 사용하면 일일 요약을 볼 수 있습니다.

목표 및 알림

사용자는 lazytrack config 명령을 통해 각 습관에 대한 일일 목표를 설정할 수 있습니다. 목표는 시간(예: 2시간) 또는 횟수(예: 8회)로 지정할 수 있으며, 목표 달성 시 콘솔에서 성공 메시지가 표시됩니다. 오후 8시 이후에 미달성 목표가 있으면 자동으로 알림이 트리거됩니다.

대화형 구성

lazytrack config 명령을 실행하면 대화형 인터페이스가 시작되어 습관의 이모지, 목표 유형, 목표 값, 기본 기간 등을 쉽게 조정할 수 있습니다. 또한 명령줄을 통해 직접 구성을 변경할 수도 있습니다(예: lazytrack config --habit code --emoji 💻).

알림 및 데몬 모드

LazyTrack은 플랫폼에 맞는 알림 방식을 사용합니다: Windows에서는 PowerShell과 System.Windows.Forms.NotifyIcon를 이용합니다. lazytrack daemon 명령을 통해 백그라운드 데몬을 실행하면, 매시간마다 미달성 목표를 확인하고 오후 8시 이후에 알림을 표시합니다. Windows에서는 scriptssetup_daemon.bat 스크립트를 통해 자동 시작을 설정할 수 있습니다.

데이터 저장

모든 습관 데이터, 로그, 설정은 JSON 형식으로 로컬에 저장됩니다. Windows에서는 %USERPROFILE%.lazytrack 폴더에 habits.json, logs.json, config.json 파일이 생성됩니다. 이 파일들은 첫 실행 시 자동으로 생성되며, 데이터를 영구히 보존합니다.

다운로드 및 설치 방법

Windows 사용자는 Chocolatey 패키지 관리자를 통해 간단히 설치할 수 있습니다. 관리자 권한으로 PowerShell을 열고 다음 명령을 실행합니다:

choco install lazytrack

또는 공식 GitHub 저장소에서 사전 빌드된 바이너리를 직접 다운로드할 수 있습니다. 다음 PowerShell 명령을 순서대로 실행합니다:

Invoke-WebRequest -Uri "https://github.com/master-wayne7/lazytrack/releases/latest/download/lazytrack_Windows_x86_64.zip" -OutFile "lazytrack.zip"
Expand-Archive lazytrack.zip -DestinationPath .

다운로드 후 압축을 해제하면 lazytrack.exe 파일을 얻을 수 있으며, 이를 원하는 위치에置く하거나 시스템 PATH에 추가하여 어디서든 실행할 수 있습니다.

기본 사용법

설치 후 터미널 또는 PowerShell에서 lazytrack 명령을 입력하면 사용 가능한 하위 명령을 확인할 수 있습니다. 주요 사용 예시는 다음과 같습니다:

• 습관 기록: lazytrack code 1h 또는 lazytrack walk 30m
• 횟수 기반 기록: lazytrack water 8x 또는 lazytrack exercise 3times
• 기본 기간 사용: lazytrack read (30분 기록)
• 주간 요약 보기: lazytrack summary
• 일일 요약 보기: lazytrack summary --daily
• 구성 변경: lazytrack config (대화형) 또는 lazytrack config --habit code --goal 2 --type duration
• 알림 확인: lazytrack reminder
• 데몬 실행: lazytrack daemon

이런 경우에 유용합니다

이 도구는 매일의 습관을 일관되게 추적하고 싶은 사람들에게 특히 유용합니다. 예를 들어, 개발자는 코딩 시간을 기록하여 집중력을 관리하고, 학생은 공부 및 운동 시간을 균형 있게 배분할 수 있습니다. 또한 물을 충분히 마시거나 규칙적으로 운동하는 등의 건강 습관을 형성하려는 사용자는 목표 설정 및 알림 기능을 통해 동기를 유지할 수 있습니다. 터미널을 자주 사용하는 사용자에게는 별도의 GUI 없이도 생산성을 높일 수 있는 가벼운 대안이 됩니다.

지원 환경·시스템 요구사항

LazyTrack은 Windows, macOS, Linux에서 실행 가능한 크로스플랫폼 도구입니다. Windows에서는 PowerShell이 지원되는 환경에서 사용할 수 있으며, 별도의 런타임 설치 없이 실행 가능한 바이너리를 제공합니다. macOS 및 Linux에서는 터미널에서 바로 실행할 수 있으며, 알림 기능을 위해 각각 osascript, notify-send 또는 유사한 시스템 도구가 필요할 수 있습니다.

최신 버전·업데이트

현재 버전은 1.0.0이며, 최신 소스 코드 및 릴리스 정보는 공식 GitHub 저장소에서 확인할 수 있습니다. 업데이트는 저장소의 releases 섹션을 통해 제공됩니다.

제한 사항·확인 사항

알림 기능은 운영체제에 따라 다르게 작동합니다. Windows에서는 PowerShell과 System.Windows.Forms.NotifyIcon에 의존하므로, 일부 보안 정책이나 그룹 정책으로 인해 알림이 차단될 수 있습니다. 또한, 데몬 모드를 사용할 경우 백그라운드에서 지속적으로 실행되므로 시스템 리소스를 소량 소비합니다. 데이터는 로컬에만 저장되며, 클라우드 동기화 기능은 내장되어 있지 않습니다.