Mỹ Lích Calendar CLI
Lịch của mình, mình tính. Hệ thống quản lý lịch cá nhân local-first trên Terminal (CLI/TUI) và tự host backend riêng tư!
Mục đích của Mỹ Lích Calendar CLI
Mỹ Lích Calendar CLI là ứng dụng mã nguồn mở quản lý lịch trình cá nhân theo kiến trúc local-first, cho phép người dùng xem, tạo và đồng bộ sự kiện lịch trực tiếp từ giao diện dòng lệnh (Terminal CLI/TUI) và máy chủ tự lưu trữ riêng biệt (Self-hosted lich-server).
📅 Mục đích Tích hợp Google Calendar (Google Calendar Integration Purpose)
Mỹ Lích Calendar CLI sử dụng phạm vi quyền Google Calendar API (https://www.googleapis.com/auth/calendar) với mục đích duy nhất: Cho phép người dùng đồng bộ hóa 2 chiều các sự kiện lịch cá nhân giữa tài khoản Google Calendar và giao diện dòng lệnh terminal của họ.
Nhờ tính năng này, các sự kiện bạn tạo trên điện thoại hoặc web Google Calendar sẽ xuất hiện tức thì trong terminal qua lệnh lich today, và các sự kiện thêm từ CLI qua lich add sẽ được đồng bộ ngược lại lên Google Calendar.
🔒 Cam kết Bảo mật & Sử dụng Dữ liệu Hợp lệ (Limited Use Compliance)
• Chỉ dùng cho tính năng lịch của người dùng: Dữ liệu Google Calendar (tiêu đề, thời gian, mô tả) chỉ được đọc và ghi khi người dùng thực hiện thao tác đồng bộ lịch.
• Không bán, không chuyển giao dữ liệu: Chúng tôi tuyệt đối không bao giờ chia sẻ, bán dữ liệu cho bên thứ ba, không dùng cho quảng cáo và không dùng để huấn luyện mô hình AI.
• Tuân thủ chính sách Google: Ứng dụng tuân thủ nghiêm ngặt chính sách Google API Services User Data Policy, bao gồm các yêu cầu về Limited Use.
Local-first Siêu Tốc
Mỹ Lích lưu trữ toàn bộ dữ liệu trong SQLite máy bạn. Mất mạng vẫn tạo/sửa lịch vèo vèo, có mạng thì tự động đồng bộ ngầm!
Google Sync 2 Chiều
Đồng bộ thông minh với Google Calendar. Áp dụng Last-Write-Wins giúp mọi thay đổi ở điện thoại hay terminal luôn chuẩn xác.
Self-hosted & Riêng Tư
Dữ liệu lịch là của bạn, không phải của các cỗ máy quảng cáo. Tự host backend riêng qua Docker chỉ với 1 lệnh compose!
Tại sao nên tự host lich-server?
Mỹ Lích CLI/TUI hoàn toàn có thể hoạt động độc lập offline trên máy tính của bạn. Nhưng khi triển khai một máy chủ lich-server riêng, bạn sẽ sở hữu một hệ sinh thái lịch cá nhân trọn vẹn và an toàn:
Nguồn Chân Lý Dữ Liệu (Source of Truth)
Bạn thực sự làm chủ 100% dữ liệu lịch trong SQLite riêng biệt. Không lo bị khóa tài khoản, không bị theo dõi hay quét dữ liệu cho mục đích quảng cáo.
Đồng Bộ Đa Thiết Bị Tức Thì
Dùng máy bàn tại nhà, laptop ở công ty, hay điện thoại: mọi thay đổi đều được đồng bộ 2 chiều mượt mà với cơ chế Last-Write-Wins thông minh.
Google Calendar Relay Tự Động
Chỉ cần cấu hình một Google OAuth App duy nhất trên server. Mọi thành viên trong gia đình hoặc nhóm có thể liên kết Google Calendar an toàn chỉ bằng 1 cú click duyệt web.
Hạ Tầng Webhook & Thông Báo
Sẵn sàng cho việc bắn thông báo sự kiện đến Gotify, Telegram hoặc hệ thống nhà thông minh (Home Assistant) mà không phụ thuộc vào ứng dụng ngoài.
docker compose up -d