An Apple Reminders CLI for power users and AI agents. RemCTL supports all the latest Reminders features such as sections, subtasks, tags, rich links, groceries lists, templates, smart lists, and image attachments. (Not affiliated with Apple.)

RemCTL – 명령줄 및 AI 도구로 Apple Reminders 제어

개요 (쉬운 언어로)

RemCTL은 macOS 전용 유틸리티로, Reminders 앱을 열지 않고 Apple Reminders를 읽고 편집할 수 있습니다. 다음을 제공합니다:

터미널 CLI (remctl …) – 리마인더, 목록, 기한, 우선순위 등을 나열, 추가, 완료, 검색, 관리합니다.
MCP(Model-Context-Protocol) 서버 – Claude Desktop, Claude Code, 기타 MCP 호환 앱과 같은 AI 어시스턴트가 동일한 명령을 프로그래밍 방식으로 호출할 수 있습니다.
Claude Code 및 Codex 플러그인 – 해당 AI 코딩 환경 내에 Reminders 작업 공간을 포함하여 “오늘” 밴드와 대화형 창을 표시합니다.
Apple 비공개 ReminderKit 기능 (섹션, 태그, 하위 작업, 스마트 목록, 템플릿 등)에 대한 액세스. --private 플래그를 전달하면 활성화됩니다.

모든 작업은 RemCTL Capability Host라는 작은 서명된 백그라운드 앱을 통해 이루어지며, macOS 권한(Reminders, Automation, Full-Disk Access)을 보유합니다. 호스트가 승인되면 CLI, 스크립트, AI 도구는 자체 권한 없이도 작동할 수 있습니다.

누가 사용할까요

파워 유저 – 작업 관리에 셸 중심 워크플로를 선호하는 분.
개발자 – Reminders를 조작하는 자동화 또는 스크립트를 구축하는 분.
AI 어시스턴트 개발자 – 에이전트(Claude, Hermes 등)가 표준 MCP 인터페이스를 통해 사용자의 Reminders를 읽고 쓸 수 있도록 하려는 분.
Mac 중심 생산성 애호가 – Reminders를 Claude Code 또는 Codex 작업 공간에 통합하려는 분.

설치 방법

다운로드 – GitHub Releases 페이지에서 서명된 DMG(RemCTL-arm64.dmg)를 다운로드하고 “Install RemCTL” 앱을 실행합니다. Capability Host, 개인용 Python 런타임을 설치하고 remctl 바이너리를 PATH에 추가합니다.
소스에서 빌드 (Intel Mac에서 필요) – Apple의 Command-Line Tools를 설치하고, 리포지토리를 클론하고, ./install.sh --from-source --bootstrap을 실행합니다. 스크립트는 로컬 서명 인증서를 만들어 호스트 앱이 업데이트 후에도 권한을 유지할 수 있도록 합니다.

두 방법 모두 macOS 암호를 한 번 요청하고 필요한 권한을 설정합니다.

주요 명령어 (빠른 참조)

remctl today                     # 오늘 또는 기한이 지난 작업 표시
remctl upcoming 7                # 향후 7일 이내 작업
remctl add "Review PR" -l Work -d "tomorrow 10:00" -p high
remctl done 23880                # 하나 이상의 ID를 완료로 표시 (최대 50)
remctl search "invoice" --json # 프로그래밍용 JSON 출력
remctl info 23880 --json         # 리마인더의 모든 저장 필드 출력

모든 명령은 --json으로 기계 판독 가능한 출력을 지원하며, 별칭 rctl / reminders도 동일하게 작동합니다.

MCP를 통한 AI 통합

remctl mcp install은 Mac의 모든 지원 AI 앱에 MCP 서버를 등록합니다.
특정 클라이언트를 지정할 수 있습니다. 예: remctl mcp install --client claude-desktop.
설치 후 AI 어시스턴트는 mcp__remctl__add, mcp__remctl__search 등의 도구를 호출할 수 있으며, AI UI 내에 대화형 리마인더 위젯을 표시할 수도 있습니다.
서버는 개인 Tailscale 네트워크를 통해 노출되어 원격 Claude Code 또는 Codex 인스턴스(--client tailscale)에서 사용할 수 있습니다.

Claude Code 플러그인 주요 기능

프롬프트 위의 “오늘” 밴드 – 개수, 기한 초과 항목, 향후 작업의 짧은 목록을 표시합니다.
/reminders 창 – Claude Code 내에 완전한 Reminders UI(리스트, 열, 캘린더 레이아웃)를 표시합니다.
JSON 설정을 통한 표시 구성(band, compact, status, pane only).
실시간 업데이트: RemCTL 기반 변경 후 또는 몇 분마다 밴드가 자동으로 새로고침됩니다.

Codex 플러그인 주요 기능

Codex 사이드바 내 완전한 Reminders 작업 공간 – 네이티브 앱의 모양(아이콘, 색상, 라이트/다크 모드)을 반영합니다.
드래그 앤 드롭, 검사기 패널, 명령 팔레트, 사용자 정의 레이아웃(리스트, 열, 캘린더).

비공개 메타데이터 지원

RemCTL은 Apple이 공개하지 않는 필드(섹션, 태그, 하위 작업 등)를 --private 플래그를 추가하여 쓸 수 있습니다. Apple의 내부 ReminderKit 프레임워크를 사용하므로 이러한 기능은 향후 macOS 릴리스에서 손상될 수 있습니다. 문서에는 현재 작동하는 비공개 키가 나열되어 있습니다.

에이전트 대응 기능

결정적 날짜 형식(YYYY-MM-DD 또는 YYYY-MM-DD HH:MM).
remctl doctor --for-agent --json은 준비 상태를 보고합니다. access.effective 필드는 Capability Host가 필요한 권한을 보유하는지 여부를 나타냅니다.
에이전트는 remctl info <id> --json으로 쓰기를 검증해야 합니다.

업데이트 및 제거

업그레이드 – 새 DMG를 다운로드하거나 최신 소스를 가져와 install.sh를 다시 실행합니다. 동일한 서명 인증서를 유지하면 기존 권한이 보존됩니다.
제거 – 번들된 스크립트 또는 ./uninstall.sh를 사용합니다. 구성 유지(--keep-config) 또는 제거될 내용을 확인하는 드라이런을 선택할 수 있습니다.

문서 및 구조

문서는 docs/ 폴더에 있습니다(설치, 명령 가이드, MCP, 플러그인, 비공개 메타데이터, 아키텍처 등).
핵심 소스 파일은 README의 Project layout 테이블에 명확히 나열되어 있습니다.
라이선스: MIT.

결론: RemCTL은 Apple Reminders와 명령줄/스크립트 워크플로 및 최신 AI 어시스턴트 사이의 진정한 완전한 브리지이며, macOS 14+ 전용으로 구축되었습니다.

viticci/remctl