tudu

A TUI client for Microsoft To-Do. Manage your task lists and tasks from the terminal.

Authenticates through the system's Microsoft Identity Broker via D-Bus, syncs with Microsoft Graph API, and caches data locally for fast startup.

Requirements

• Linux with Microsoft Identity Broker (e.g. Intune-enrolled or microsoft-identity-broker installed)
• Rust 2024 edition

Install

cargo install --path .

Usage

tudu                             # uses default client ID
tudu --client-id <ID>            # override client ID
TUDU_CLIENT_ID=<ID> tudu        # via env var

Keyboard Shortcuts

Navigation

Key	Action
j / ↓	Move down
k / ↑	Move up
Tab	Switch pane
Enter	Select list / view tasks
Esc	Go back to lists

Actions

Key	Action
a	New task (in Tasks pane)
A	New list (in Lists pane)
e	Edit task title
x / Space	Toggle complete
d	Delete task (with confirmation)

View

Key	Action
r	Refresh from server
h	Toggle completed tasks
? / F1	Help
q / Ctrl+C	Quit

Cache

Data is cached at ~/.cache/tudu/ and auto-refreshes every 15 minutes. Press r to force a refresh.