What is todoist-graph?

Todoist Graph is a small desktop app for Mac and Windows that shows a GitHub style contribution heatmap, but built from your own Todoist task completion history instead of code commits. It is built with Electron, so it runs as its own window rather than inside a web browser. After installing, you paste in your personal Todoist API token, which is verified against Todoist and then stored only on your own computer. The app fetches your completed tasks and displays them as a grid of colored cells, one per day, with color intensity showing how many tasks you finished that day. The heatmap paints instantly from a local cache and then quietly refreshes with new data in the background, so there is no loading spinner when you open it. Several small touches round out the app: a choice of color themes including GitHub, Claude, and the full range of Todoist's own palette options, a zoom control from 80 to 200 percent, optional month and day of week labels, a tooltip that shows the date, task count, and up to four task names when you hover a cell, and an optional stats row showing totals, current streak, best day, and active days. The window is frameless with a custom drag area, and your window size, theme, zoom level, and other settings are remembered between launches. On the technical side, the Todoist API token is kept only in Electron's main process and never passed to the on screen interface, and the app uses Electron's context isolation and disables Node integration in the renderer as a security measure. Data fetching is paginated and aware of Todoist's rate limits, backing off automatically if it receives a 429 response. Installation is a signed free download from the project's GitHub Releases page as a DMG file, since the app is not code signed by Apple, macOS will initially block it and require you to right click and choose Open once. The project is released under the MIT license.