things-mac

Things 3 CLI

things 명령어를 사용하여 로컬 Things 데이터베이스(받은 편지함/오늘/검색/프로젝트/영역/태그)를 읽고 Things URL 스킴을 통해 할 일을 추가/업데이트합니다.

설정

• 설치 (권장, Apple Silicon): GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
• DB 읽기 실패 시: 호출 앱(수동 실행 시 터미널; 게이트웨이 실행 시 OpenClaw.app)에 전체 디스크 접근 권한을 부여하세요.
• 선택 사항: THINGSDB 설정 (또는 --db 전달)으로 ThingsData-* 폴더를 가리킵니다.
• 선택 사항: THINGS_AUTH_TOKEN을 설정하여 업데이트 작업 시 --auth-token 전달을 생략합니다.

읽기 전용 (DB)

• things inbox --limit 50
• things today
• things upcoming
• things search "쿼리"
• things projects / things areas / things tags

쓰기 (URL 스킴)

• 안전한 미리보기 권장: things --dry-run add "제목"
• 추가: things add "제목" --notes "..." --when 오늘 --deadline 2026-01-02
• Things를 전면으로 가져오기: things --foreground add "제목"

예제: 할 일 추가

• 기본: things add "우유 사기"
• 메모 포함: things add "우유 사기" --notes "2% + 바나나"
• 프로젝트/영역에 추가: things add "항공권 예약" --list "여행"
• 프로젝트 헤딩 아래에 추가: things add "충전기 챙기기" --list "여행" --heading "출발 전"
• 태그 포함: things add "치과 예약" --tags "건강,전화"
• 체크리스트: things add "여행 준비" --checklist-item "여권" --checklist-item "티켓"
• STDIN에서 읽기 (여러 줄 => 제목 + 메모):
  • cat <<'EOF' | things add -
  • 제목 줄
  • 메모 줄 1
  • 메모 줄 2
  • EOF

예제: 할 일 수정 (인증 토큰 필요)

• 먼저 ID(UUID 열) 가져오기: things search "우유" --limit 5
• 인증: THINGS_AUTH_TOKEN 설정 또는 --auth-token <토큰> 전달
• 제목: things update --id <UUID> --auth-token <토큰> "새 제목"
• 메모 교체: things update --id <UUID> --auth-token <토큰> --notes "새 메모"
• 메모 추가/앞에 추가: things update --id <UUID> --auth-token <토큰> --append-notes "..." / --prepend-notes "..."
• 목록 이동: things update --id <UUID> --auth-token <토큰> --list "여행" --heading "출발 전"
• 태그 교체/추가: things update --id <UUID> --auth-token <토큰> --tags "a,b" / things update --id <UUID> --auth-token <토큰> --add-tags "a,b"
• 완료/취소 (소프트 삭제 비슷): things update --id <UUID> --auth-token <토큰> --completed / --canceled
• 안전한 미리보기: things --dry-run update --id <UUID> --auth-token <토큰> --completed

할 일 삭제?

• 현재 things3-cli에서 지원되지 않습니다 ("삭제/휴지통으로 이동" 쓰기 명령어 없음; things trash는 읽기 전용 목록).
• 대안: Things UI를 사용하여 삭제/휴지통으로 이동하거나 things update를 통해 --completed / --canceled로 표시하세요.

참고

• macOS 전용입니다.
• --dry-run은 URL을 출력하고 Things를 열지 않습니다.