viticci/remctl

해결하는 문제

RemCTL은 macOS 리마인더를 위한 커맨드 라인 인터페이스(CLI)를 제공하여 파워 유저와 AI 에이전트가 프로그래밍 방식으로 작업을 관리할 수 있도록 합니다. 리마인더 데이터베이스에 빠르고 상세한 액세스를 제공하여 표준 API의 한계를 극복하며, 여기에는 기본 스크립팅으로는 접근할 수 없는 섹션, 태그, 스마트 목록과 같은 고급 기능에 대한 지원이 포함됩니다.

작동 방식

RemCTL은 속도, 권한 및 시스템 안정성의 균형을 맞추기 위해 하이브리드 아키텍처를 사용합니다:

• 읽기 경로: 로컬 iCloud 리마인더 데이터베이스에서 직접 SQLite 읽기를 수행하여 상세한 메타데이터에 거의 즉각적으로 액세스합니다.
• 쓰기 경로: Apple의 공개 EventKit API를 사용하여 변경 사항이 기기 간에 올바르게 동기화되도록 합니다.
• 프라이빗 API 경로: 고급 메타데이터(하위 작업, 태그, 식료품 목록 분류 등)의 경우, 명시적인 --private 플래그를 통해 선택적으로 프라이빗 ReminderKit 프레임워크를 사용합니다.
• 권한 호스트: 권한 관리를 단순화하기 위해 대부분의 명령은 서명된 RemCTL Capability Host.app을 통해 라우팅됩니다. 이 앱은 필요한 전체 디스크 접근 및 자동화 권한을 보유하고 있으므로, 호출하는 터미널이나 에이전트가 개별적으로 이를 가질 필요가 없습니다.

대상 사용자

• macOS 파워 유저: 터미널이나 셸 스크립트를 통해 리마인더를 관리하려는 사용자.
• AI 에이전트: 사용자의 작업 목록과 상호 작용할 수 있는 신뢰할 수 있는 방법이 필요한 에이전트(예: Claude Code 또는 Codex 사용)를 구축하는 개발자.

주요 기능

• 깊은 통합: 섹션, 하위 작업, 태그, 이미지 첨부 파일 및 사용자 정의 스마트 목록을 지원합니다.
• 에이전트 친화적: LLM과의 쉬운 통합을 위해 JSON 출력과 구조화된 명령 맵을 제공합니다.
• 스마트 목록 관리: 우선순위, 날짜 또는 플래그를 기반으로 사용자 정의 스마트 목록을 만들고 편집하는 기능.
• 식료품 목록 지원: 식료품별 메타데이터의 네이티브 처리 및 자동 분류.
• 유연한 일정 관리: 자연어와 유사한 날짜 구문 분석(예: "tomorrow 3pm", "+3d", "eod")을 지원합니다.