Downloads

Python Versions

GitHub CI Status

License: MIT

Todoist 작업 스케줄러 및 필터러

저는 Todoist의 헤비 유저이며 다음과 같은 점을 발견했습니다:

1. 완료해야 할 작업 목록이 작으면, 더 빨리 처리할 수 있습니다.
2. 많은 양의 작업 목록은 '인지적 부담(cognitive drag)'을 만들고 스트레스를 줍니다.
3. 긴 작업 목록을 검토하고 확인하는 데 시간이 걸립니다.

이 도구는 오늘 완료할 필요가 없는 작업을 자동으로 제외하도록 규칙을 설정할 수 있게 해줍니다. 이를 통해 todoist 목록의 크기를 줄이고, 당신의 마음(monkey mind)이 더 많은 것을 할 수 있도록 속입니다. 저의 궁극적인 목표는 todoist에서 '인박스 제로(inbox zero)'에 도달하는 것입니다.

이 도구는 일종의 '가상 비서' 역할을 하여 큰 도움을 주었습니다. 즉, 하루 동안 제가 보지 말아야 할 것을 자동으로 결정해 줍니다. 저는 이를 hyper focus에서 실행되는 '기상 직후(first awake)' 스크립트에 연결합니다.

설치

uv tool install todoist-scheduler

또는 의존성으로 추가할 수 있습니다:

uv add todoist-scheduler

사용법

Usage: todoist-scheduler [OPTIONS]

  사용자 정의 규칙에 따라 todoist 작업을 정리합니다.
...

기본 필터를 자세히 살펴보세요:

default: (today | overdue) & !assigned to:others & !recurring

이것은 다음과 같은 역할을 합니다:

• 할당된 사용자에게만 필터를 적용합니다.
• 반복되는 작업(recurring tasks)은 무시합니다.
• 오늘 또는 그 이전에 마감된 작업을 확인합니다.

filters.json 스키마

[
  // limit은 오늘 완료할 수 있다고 생각하는 작업의 개수를 정의합니다
  { "filter": "@writing", "limit": 2 },
...

JSON 파일은 주석을 추가할 수 있도록 JSON5로 로드됩니다.

특정 항목에 대한 옵션을 재정의하거나 저장된/이름 지정 필터를 참조할 수도 있습니다:

Docker

가장 쉽게 사용하는 방법은 미리 빌드된 docker 이미지를 이용하는 것입니다. 예시로 docker-compose.yml을 참고하세요. 이 설정은 main.py를 cron과 유사한 진입점(entrypoint)으로 사용하여 스케줄에 따라 이 스크립트를 실행합니다.

개발 (Development)

디버그 로깅으로 실행하려면:

LOG_LEVEL=DEBUG todoist-scheduler

Todoist API를 이용해 테스트해보세요 (ipython에서):

from todoist_api_python.api import TodoistAPI
import os

...

*이 프로젝트는 iloveitaly/python-package-template에서 생성되었습니다.