업무 일지 CLI 명세 메모 (v0.0.1)
notJoon @joonnot@hackers.pub
해야 할 작업 목록과 업무 일지를 txt 파일로 관리하고 있다. 그런데 작성하다 보니 날짜를 잘못 입력하거나, 태그를 빠뜨리는 실수가 종종 생겨서 아예 CLI 도구로 만들기로 했다.
현재 사용 중인 문서 형식은 다음과 같다. 섹션은 크게 TODO, DONE, 메모(주로 #TIL, #메모로 표기)로 구성된다.
[빈 줄 (선택)]
YYYY-MM-DD
==========
[섹션들...]
YYYY-MM-DD
==========
[섹션들...]기능 명세
1. 날짜 자동 생성
cron을 이용해 매일 자정(00:00)에 새 날짜 섹션을 자동 생성한다.
2026-01-21
==========
최신 날짜가 파일 상단에 위치하며, 이전 날짜와는 빈 줄로 구분한다.
2. TODO 추가 및 편집
todo 명령으로 오늘의 할 일을 추가하거나 편집한다.
$ tag todo- 오늘 날짜 섹션이 없으면 자동 생성
- TODO 섹션이 없으면 에디터에서 새로 작성
- TODO 섹션이 이미 있으면 해당 내용을 에디터로 불러와 편집
TODO
- 첫 번째 할 일
- 두 번째 할 일
. 세부 항목 A
- 더 깊은 항목
. 세부 항목 B3. 완료 기록
done 명령으로 완료한 작업을 기록한다. 명령 실행 시점의 시간이 자동으로 추가된다.
$ tag done시간 형식은 [오전|오후 HH:MM]이며, 24시간제로 표기한다.
[오전 10:40]
- 완료한 작업 내용
[오후 14:30]
- 또 다른 완료 항목
. 관련 세부 사항
. 추가 메모4. 메모 및 커스텀 태그
note 명령으로 메모를 추가한다. 태그를 인자로 전달하면 해당 태그로 섹션이 생성된다. [명세 업데이트 필요]
$ tag note # "노트:" 헤더로 추가
$ tag note TIL # "#TIL" 헤더로 추가
$ tag note memo # "#memo" 헤더로 추가(자주 사용하는 태그는 단축 명령을 지원하는 것도 좋아보임)
note 명령 이후에 오는 태그는 종류에 상관없이 # 접두사를 붙여 커스텀 태그로 활용할 수 있어야 한다.
$ tag note foo # `#foo`
$ tag note idea # `#idea`5. 불렛 포인트 규칙
들여쓰기 깊이에 따라 -와 .가 교차한다. 스페이스 1칸이 1레벨이다.
| 깊이 | 들여쓰기 | 불렛 | 예시 |
|---|---|---|---|
| 1 | 1칸 | - |
- 항목 |
| 2 | 2칸 | . |
. 항목 |
| 3 | 3칸 | - |
- 항목 |
| 4 | 4칸 | . |
. 항목 |
에디터에서 아무 불렛(-, ., *)으로 작성해도 저장 시 규칙에 맞게 변환된다.
6. 환경 설정
환경 변수로 기본 동작을 변경할 수 있다.
| 변수 | 기본값 | 설명 |
|---|---|---|
TAG_FILE |
~/todo.txt |
TODO 파일 경로 |
EDITOR |
vim |
사용할 에디터 |
export TAG_FILE="$HOME/Documents/work.txt"
export EDITOR="nvim"파일 예시
2026-01-20
==========
TODO
- 첫 번째 할 일
- 두 번째 할 일
. 세부 항목 A
- 더 깊은 항목
[오전 10:30]
- 오전에 완료한 작업
[오후 15:00]
- 오후에 완료한 작업
. 관련 메모
#memo
기억해둘 내용 작성
#TIL
- 오늘 배운 것
. 세부 내용
2026-01-19
==========
TODO
- 어제의 할 일 목록
[오전 11:00]
- 어제 완료한 작업
노트:
자유 형식의 메모 내용