FAQ
Frequently asked questions
Where is my data stored?
All your todos are stored as JSON files on your Mac — they never leave your device. We collect minimal anonymous analytics (app version, theme) to improve the app, but no todo content or personal data.
Does todoglow sync across devices?
Not yet. todoglow is designed as a focused, single-device todo app. Cloud sync may come in the future, but we want to keep things simple for now.
What's the AI Polish feature?
Type ; or ⌘P in the input field to enter polish mode. Your text will be polished by AI — fixing typos, improving grammar, or even translating. You need to bring your own Gemini API key (Settings → Lab).
Yes, it's not the friendliest setup. AI integration is tricky to offer for free — we're still figuring out the right approach.
Are all themes included?
Yes! All 13 themes (12 dark + 1 light) are included with your license. No extra purchases needed. Light mode was added in v1.3.0.
Can I hide the Dock icon?
Yes! Go to Settings (gear icon) → Toggle "Show Dock Icon". todoglow will live only in your menu bar.
Do shortcuts work on non-US keyboards?
Yes! todoglow shortcuts are based on physical key positions, not the characters printed on your keycaps. Select your layout to see how it maps:
Same physical position, same shortcut — regardless of your keyboard layout.
From v1.6.5, you can select your keyboard layout in Settings → Display. All shortcut labels in the app will adapt accordingly. You can also press F1 as a universal alternative for the help shortcut.
How does AI Agent Integration work?
AI coding tools like Claude Code and Cursor can push work topics directly to todoglow via MCP (Model Context Protocol).
Claude Code (stdio)
1. Install: claude mcp add -s user todoglow -- npx todoglow-mcp@latest
2. Start a new Claude session (close and reopen) for it to take effect
3. Your AI assistant will automatically set and update the current work topic
4. Check agent thread status in the Agents panel
Other HTTP MCP clients
1. Run: npx todoglow-mcp@latest --transport http --port 26214
2. In your client, add server URL: http://localhost:26214/mcp
3. Set authentication to Open (no auth needed)
4. Keep the terminal running while using the client
Available from v1.1.0. Settings → Lab for setup details.
How does Dashboard Stats work?
Press ⌘U to open the stats dashboard. It tracks both completed count and active time spent on each todo.
What's tracked
The big number shows how many todos you completed. Charts and visualizations (activity pulse, time-of-day distribution, contribution dots) are based on how much time you actively spent.
Four views
⌘1 Day — ECG-style activity pulse across 24 hours
⌘2 Week — bar sparkline + generative weekly glyph
⌘3 Month — ASCII bar charts + peak hours analysis
⌘4 All-time — contribution dots + lifetime stats
Available from v1.5.0. Use ← → to navigate between periods.
How do I uninstall?
1. Quit todoglow (right-click menu bar icon → Quit)
2. Drag todoglow from Applications to Trash
3. (Optional) Remove data folder from ~/Library/Application Support/
Still have questions?
hello@devglow.app