todo-cli
Todo CLI
A cross-platform command-line interface to interact with Microsoft To Do, built using .NET 8.
Build Status
| Platform | Status |
|---|---|
| CI | |
| CD |
Getting Started
Install
If you just want to give it a spin, head over to releases. Download a release and extract to somewhere in your PATH, and run todo --help to get started.
Build
# Clone the repository
git clone https://github.com/mehmetseckin/todo-cli.git
# Navigate into the source code folder
cd .\todo-cli\src
# Build the project
dotnet build
Run
The application will automatically prompt you to sign in with your Microsoft account, and ask for your consent to access your data when needed.
# Run using dotnet run
dotnet run -p .\Todo.CLI -- --help
# Run from build output
.\src\publish\todo.exe --help
Publish (self-contained .exe)
# Windows x64
dotnet publish src\Todo.CLI -c Release -r win-x64 -o .\src\publish
# macOS (Intel)
dotnet publish src\Todo.CLI -c Release -r osx-x64 -o .\src\publish
# macOS (Apple Silicon)
dotnet publish src\Todo.CLI -c Release -r osx-arm64 -o .\src\publish
# Linux x64
dotnet publish src\Todo.CLI -c Release -r linux-x64 -o .\src\publish
Usage
Commands
| Command | Description |
|---|---|
todo add item <subject> |
Add a new to-do item |
todo add list <name> |
Add a new to-do list |
todo list [options] |
List items |
todo complete <id> |
Mark an item as completed |
todo remove <id> |
Remove an item |
Options
| Option | Description |
|---|---|
--list <name> |
Target a specific list |
--star |
Mark the item as important |
--due-date <date> |
Set a due date (yyyy-MM-dd or MM-dd) |
Examples
# Add an item with a due date
todo add item "Buy groceries" --due-date 2026-05-20
# Add an item with MM-dd format (current year is used)
todo add item "Doctor appointment" --due-date 06-15
# Add a starred item to a specific list
todo add item "Important report" --star --list Work
# List all tasks
todo list
# Mark a task as completed
todo complete <task-id>
# Remove a task
todo remove <task-id>
Output Example
Work (3):
- Buy groceries - NotStarted (05-20)
✓ Completed task - Completed (2026-05-10)
- Important report - NotStarted
Contributing
Interested? You are awesome. Feel free to fork, do your thing and send a PR! Everything is appreciated.
Code of Conduct
Be nice to people, give constructive feedback, and have fun!
Stack
This project is built using the following nuggets of awesomeness, and many more. Many thanks to the folks who are working on and maintaining these products.