abhisheknaiidu/todoist-readme

📋 Tự động cập nhật Todoist Stats lên GitHub README

Một GitHub Action nhẹ nhàng biến README thành bảng điều khiển hiển thị tiến độ làm việc từ Todoist — không cần manual update nữa.

Dự án abhisheknaiidu/todoist-readme là một GitHub Action tự động kéo dữ liệu thống kê từ Todoist API và chèn vào đúng vị trí đã chỉ định trong file README.md của repository. Người dùng chỉ cần thiết lập một workflow đơn giản là GitHub Action sẽ chạy theo lịch hoặc thủ công để làm mới thông tin mỗi phút.

✨ Điểm nổi bật

• Todoist API integration: Kết nối trực tiếp với Todoist API để lấy thống kê nhiệm vụ, tiến độ hoàn thành.
• GitHub Actions tự động: Hỗ trợ chạy theo lịch (cron: "* * * * *" — mỗi phút) hoặc kích hoạt thủ công qua workflow_dispatch.
• Phân biệt Premium/Free: Cấu hình PREMIUM: true cho người dùng trả phí, PREMIUM: "" cho người dùng miễn phí — workflow khác nhau tùy gói.
• Chèn vào README bằng comment marker: Sử dụng cặp tag <!-- TODO-IST:START --> và <!-- TODO-IST:END --> làm điểm neo để action tự động cập nhật nội dung bên trong.
• Setup đơn giản: Chỉ cần thêm API token vào GitHub Secrets (TODOIST_API_KEY) và copy đoạn workflow YAML là chạy được.
• Linh hoạt lịch chạy: Cron mặc định mỗi phút, có thể tùy chỉnh theo nhu cầu.

💡 Vì sao đáng chú ý

Dự án giải quyết đúng nhu cầu của lập trình viên muốn hiển thị tiến độ công việc Todoist trực tiếp trên profile GitHub mà không phải tự cập nhật thủ công mỗi ngày. Thay vì phải copy-paste stats vào README, GitHub Action tự xử lý toàn bộ — kéo dữ liệu từ Todoist, inject vào đúng vị trí trong README, và commit thay đổi.

Dễ triển khai, không phụ thuộc framework phức tạp, hoạt động ngay cả với repository cá nhân không có nhiều cấu hình CI/CD. Phù hợp cho ai muốn biến README thành một dashboard mini hiển thị năng suất cá nhân.

#Todoist #GitHubActions #TodoistAPI #TimeTracker #OpenSource #TiniX