things-mac

• macOS에서 Things 3를 사용하고 있으며, AI 에이전트가 받은 편지함, 오늘 목록 또는 특정 프로젝트에 직접 작업을 추가하길 원합니다.
• Things 데이터베이스를 조회하고 싶습니다 — 예: "오늘 마감인 항목이 뭐야?" 또는 "health 태그가 달린 작업 검색해줘" — 앱을 열지 않고도 가능합니다.
• 기존 할 일을 업데이트해야 합니다: 제목 변경, 노트 추가, 다른 프로젝트로 이동, 태그 추가, 또는 완료/취소 처리.
• 작업 내용이 Things 데이터에 실제로 반영되기 전에 쓰기 작업의 미리보기(dry-run)를 확인하고 싶습니다.

• macOS를 사용하고 있지 않습니다 — 이 스킬은 Darwin 전용이며 Linux 또는 Windows에서는 작동하지 않습니다.
• 할 일을 영구적으로 삭제하거나 휴지통으로 이동해야 합니다; 삭제 기능은 기본 CLI 도구에서 지원되지 않습니다.
• Things 3가 설치되어 있지 않습니다. 이 스킬은 디스크에 활성화된 Things 3 데이터베이스가 필요합니다.

things-mac의 SQLite 데이터베이스에서 직접 받은 편지함, 오늘, 예정, 및 로그북 보기를 조회합니다. Things 3이 열려 있지 않아도 사용할 수 있습니다. --limit 필터링을 지원하며, 후속 작업을 위한 UUID를 포함한 구조화된 데이터를 반환합니다.

단일 명령어로 메모, 마감일(--when, --deadline), 프로젝트/영역 지정(--list), 제목, 태그, 체크리스트 항목을 포함한 새 작업을 생성하세요 — 모두 things-mac을 통해 가능합니다. 여러 줄의 제목과 메모 입력을 위한 STDIN 파이프 연결도 지원됩니다.

UUID로 모든 작업을 수정할 수 있습니다: 이름 변경, 메모 교체 또는 앞뒤에 내용 추가, 프로젝트 간 이동, 태그 업데이트, 완료 또는 취소 표시. 쓰기 작업을 위해 Things 인증 토큰이 필요합니다.

--dry-run을 전달하면 실제로 Things를 열거나 변경 사항을 커밋하지 않고 Things URL 스킴 페이로드를 출력합니다 — 실행 전에 에이전트가 생성한 작업을 검증하는 데 유용합니다.

키워드로 작업을 찾기 위해 things-mac 데이터베이스에서 전체 텍스트 검색을 실행하며, 이후 업데이트 명령에 필요한 UUID와 메타데이터를 반환합니다.

에이전트가 추측 없이 새 작업을 올바른 대상으로 지능적으로 라우팅할 수 있도록 Things 3 설정의 모든 프로젝트, 영역 및 태그를 나열합니다.

에이전트와 회의나 아이디어에 대해 대화하는 중에 "이걸 내 things-mac 받은 함에 추가해줘"라고 말하면, 스킬이 언급된 메모나 마감일과 함께 즉시 작업을 생성합니다 — 복사 붙여넣기가 필요 없습니다.

에이전트에게 Things 3의 오늘 및 예정 목록을 불러오도록 요청하여 우선순위를 검토하거나, 요약을 받거나, 에이전트가 작업 일정을 재조정하거나 주석을 추가하는 데 도움을 받을 수 있습니다.

키워드로 작업을 검색하고 UUID를 가져온 다음, 새 메모를 추가하거나 다른 프로젝트로 이동시킵니다 — 작업이 존재한다는 것은 기억하지만 새로운 정보를 추가해야 할 때 유용합니다.

여행이나 프로젝트를 계획할 때, 에이전트에게 한 번의 대화로 특정 things-mac 프로젝트와 제목에 할당된 체크리스트가 포함된 여러 할 일을 생성하도록 요청하세요.