microsoft-todo-cli 1.0.0__tar.gz → 1.1.0__tar.gz

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.1.0}/CHANGES.txt

@@ -1,3 +1,9 @@
+v1.1.0, 2026-02-05
+  - Added note support: note, show-note, clear-note commands
+  - Added sn, cn aliases for show-note and clear-note
+  - Notes are now displayed in show command and JSON output
+  - Added note field to Task model
+
 v1.0.0, 2026-02-04
   - Fork from kiblee/tod0 with redesigned CLI
   - Removed interactive TUI, CLI-only

{microsoft_todo_cli-1.0.0/microsoft_todo_cli.egg-info → microsoft_todo_cli-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-todo-cli
-Version: 1.0.0
+Version: 1.1.0
 Summary: Fast, minimal command-line client for Microsoft To-Do
 Home-page: https://github.com/underwear/microsoft-todo-cli
 Author: underwear
@@ -141,6 +141,16 @@ todo uncomplete-step "Task" "Step"    # Uncheck
 todo rm-step "Task" 0                 # Remove by index
 ```
 
+### Notes
+
+```bash
+todo note "Task" "Note content"       # Add/update note
+todo show-note "Task"                 # Display note (alias: sn)
+todo clear-note "Task"                # Remove note (alias: cn)
+```
+
+Notes are text content attached to a task. Use `todo show "Task"` to see the note along with other task details.
+
 ### Lists
 
 ```bash
@@ -279,6 +289,7 @@ With `--json`: stdout contains only valid JSON on success. Errors go to stderr.
 | `t` | `tasks` | `d` | `rm` |
 | `n` | `new` | `newl` | `new-list` |
 | `c` | `complete` | `reopen` | `uncomplete` |
+| `sn` | `show-note` | `cn` | `clear-note` |
 
 ```bash
 todo t                  # = todo tasks
@@ -287,6 +298,12 @@ todo c 0 1 2            # = todo complete 0 1 2
 todo d "Old" -y         # = todo rm "Old" -y
 ```
 
+## Claude Code
+
+A skill for [Claude Code](https://claude.ai/download) is available:
+
+**[todo skill](https://github.com/underwear/claude-code-underwear-skills/blob/main/skills/todo/SKILL.md)** — enables Claude to manage your Microsoft To-Do tasks directly.
+
 ## Credits
 
 Forked from [kiblee/tod0](https://github.com/kiblee/tod0) with a redesigned CLI.

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.1.0}/README.md

@@ -103,6 +103,16 @@ todo uncomplete-step "Task" "Step"    # Uncheck
 todo rm-step "Task" 0                 # Remove by index
 ```
 
+### Notes
+
+```bash
+todo note "Task" "Note content"       # Add/update note
+todo show-note "Task"                 # Display note (alias: sn)
+todo clear-note "Task"                # Remove note (alias: cn)
+```
+
+Notes are text content attached to a task. Use `todo show "Task"` to see the note along with other task details.
+
 ### Lists
 
 ```bash
@@ -241,6 +251,7 @@ With `--json`: stdout contains only valid JSON on success. Errors go to stderr.
 | `t` | `tasks` | `d` | `rm` |
 | `n` | `new` | `newl` | `new-list` |
 | `c` | `complete` | `reopen` | `uncomplete` |
+| `sn` | `show-note` | `cn` | `clear-note` |
 
 ```bash
 todo t                  # = todo tasks
@@ -249,6 +260,12 @@ todo c 0 1 2            # = todo complete 0 1 2
 todo d "Old" -y         # = todo rm "Old" -y
 ```
 
+## Claude Code
+
+A skill for [Claude Code](https://claude.ai/download) is available:
+
+**[todo skill](https://github.com/underwear/claude-code-underwear-skills/blob/main/skills/todo/SKILL.md)** — enables Claude to manage your Microsoft To-Do tasks directly.
+
 ## Credits
 
 Forked from [kiblee/tod0](https://github.com/kiblee/tod0) with a redesigned CLI.

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.1.0/microsoft_todo_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-todo-cli
-Version: 1.0.0
+Version: 1.1.0
 Summary: Fast, minimal command-line client for Microsoft To-Do
 Home-page: https://github.com/underwear/microsoft-todo-cli
 Author: underwear
@@ -141,6 +141,16 @@ todo uncomplete-step "Task" "Step"    # Uncheck
 todo rm-step "Task" 0                 # Remove by index
 ```
 
+### Notes
+
+```bash
+todo note "Task" "Note content"       # Add/update note
+todo show-note "Task"                 # Display note (alias: sn)
+todo clear-note "Task"                # Remove note (alias: cn)
+```
+
+Notes are text content attached to a task. Use `todo show "Task"` to see the note along with other task details.
+
 ### Lists
 
 ```bash
@@ -279,6 +289,7 @@ With `--json`: stdout contains only valid JSON on success. Errors go to stderr.
 | `t` | `tasks` | `d` | `rm` |
 | `n` | `new` | `newl` | `new-list` |
 | `c` | `complete` | `reopen` | `uncomplete` |
+| `sn` | `show-note` | `cn` | `clear-note` |
 
 ```bash
 todo t                  # = todo tasks
@@ -287,6 +298,12 @@ todo c 0 1 2            # = todo complete 0 1 2
 todo d "Old" -y         # = todo rm "Old" -y
 ```
 
+## Claude Code
+
+A skill for [Claude Code](https://claude.ai/download) is available:
+
+**[todo skill](https://github.com/underwear/claude-code-underwear-skills/blob/main/skills/todo/SKILL.md)** — enables Claude to manage your Microsoft To-Do tasks directly.
+
 ## Credits
 
 Forked from [kiblee/tod0](https://github.com/kiblee/tod0) with a redesigned CLI.

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.1.0}/microsoft_todo_cli.egg-info/SOURCES.txt

@@ -23,6 +23,8 @@ tests/test_filters.py
 tests/test_json_output.py
 tests/test_lst_output.py
 tests/test_models.py
+tests/test_note_cli.py
+tests/test_note_wrapper.py
 tests/test_odata_escape.py
 tests/test_recurrence.py
 tests/test_update_command.py

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.1.0}/tests/test_models.py

@@ -230,6 +230,99 @@ class TestTaskModel(unittest.TestCase):
 
         self.assertIsNotNone(task.body_last_modified_datetime)
 
+    def test_task_with_note(self):
+        """Test task with note (body content)"""
+        api_response = {
+            "id": "task123",
+            "title": "Task with note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+            "body": {
+                "content": "This is my note content",
+                "contentType": "text",
+            },
+        }
+        task = Task(api_response)
+
+        self.assertEqual(task.note, "This is my note content")
+        self.assertEqual(task.note_content_type, "text")
+
+    def test_task_without_note(self):
+        """Test task without note (no body field)"""
+        api_response = {
+            "id": "task123",
+            "title": "Task without note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+        }
+        task = Task(api_response)
+
+        self.assertEqual(task.note, "")
+        self.assertEqual(task.note_content_type, "text")
+
+    def test_task_with_empty_note(self):
+        """Test task with empty note (body with empty content)"""
+        api_response = {
+            "id": "task123",
+            "title": "Task with empty note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+            "body": {
+                "content": "",
+                "contentType": "text",
+            },
+        }
+        task = Task(api_response)
+
+        self.assertEqual(task.note, "")
+
+    def test_task_note_in_to_dict(self):
+        """Test that note is included in to_dict output"""
+        api_response = {
+            "id": "task123",
+            "title": "Task with note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+            "body": {
+                "content": "Note for JSON",
+                "contentType": "text",
+            },
+        }
+        task = Task(api_response)
+        task_dict = task.to_dict()
+
+        self.assertIn("note", task_dict)
+        self.assertEqual(task_dict["note"], "Note for JSON")
+
+    def test_task_empty_note_in_to_dict(self):
+        """Test that empty note is None in to_dict output"""
+        api_response = {
+            "id": "task123",
+            "title": "Task without note",
+            "importance": "normal",
+            "status": "notStarted",
+            "createdDateTime": "2024-01-25T10:00:00.0000000Z",
+            "lastModifiedDateTime": "2024-01-25T11:00:00.0000000Z",
+            "isReminderOn": False,
+        }
+        task = Task(api_response)
+        task_dict = task.to_dict()
+
+        self.assertIn("note", task_dict)
+        self.assertIsNone(task_dict["note"])
+
 
 if __name__ == "__main__":
     unittest.main()

microsoft_todo_cli-1.1.0/tests/test_note_cli.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+"""Unit tests for note CLI commands (argument parsing)"""
+
+import unittest
+from todocli.cli import setup_parser
+
+
+class TestNoteCLIArgParsing(unittest.TestCase):
+    """Test that CLI parsers correctly parse note command arguments"""
+
+    def setUp(self):
+        self.parser = setup_parser()
+
+    # note command
+
+    def test_note_basic(self):
+        """Test note command with task name and content"""
+        args = self.parser.parse_args(["note", "Buy groceries", "Remember to check prices"])
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.note_content, "Remember to check prices")
+
+    def test_note_with_list_flag(self):
+        """Test note command with --list flag"""
+        args = self.parser.parse_args(
+            ["note", "Buy groceries", "Remember to check prices", "-l", "Shopping"]
+        )
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.note_content, "Remember to check prices")
+        self.assertEqual(args.list, "Shopping")
+
+    def test_note_with_id_flag(self):
+        """Test note command with --id flag"""
+        args = self.parser.parse_args(
+            ["note", "--id", "task123", "This is a note"]
+        )
+        self.assertEqual(args.task_id, "task123")
+        self.assertEqual(args.note_content, "This is a note")
+
+    def test_note_with_json_flag(self):
+        """Test note command with --json flag"""
+        args = self.parser.parse_args(
+            ["note", "Buy groceries", "Note content", "--json"]
+        )
+        self.assertTrue(args.json)
+
+    # show-note command
+
+    def test_show_note_basic(self):
+        """Test show-note command with task name"""
+        args = self.parser.parse_args(["show-note", "Buy groceries"])
+        self.assertEqual(args.task_name, "Buy groceries")
+
+    def test_show_note_with_list_flag(self):
+        """Test show-note command with --list flag"""
+        args = self.parser.parse_args(["show-note", "Buy groceries", "-l", "Shopping"])
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.list, "Shopping")
+
+    def test_show_note_with_id_flag(self):
+        """Test show-note command with --id flag"""
+        args = self.parser.parse_args(["show-note", "--id", "task123"])
+        self.assertEqual(args.task_id, "task123")
+
+    def test_show_note_with_json_flag(self):
+        """Test show-note command with --json flag"""
+        args = self.parser.parse_args(["show-note", "Buy groceries", "--json"])
+        self.assertTrue(args.json)
+
+    def test_show_note_alias_sn(self):
+        """Test sn alias for show-note command"""
+        args = self.parser.parse_args(["sn", "Buy groceries"])
+        self.assertEqual(args.task_name, "Buy groceries")
+
+    # clear-note command
+
+    def test_clear_note_basic(self):
+        """Test clear-note command with task name"""
+        args = self.parser.parse_args(["clear-note", "Buy groceries"])
+        self.assertEqual(args.task_name, "Buy groceries")
+
+    def test_clear_note_with_list_flag(self):
+        """Test clear-note command with --list flag"""
+        args = self.parser.parse_args(["clear-note", "Buy groceries", "-l", "Shopping"])
+        self.assertEqual(args.task_name, "Buy groceries")
+        self.assertEqual(args.list, "Shopping")
+
+    def test_clear_note_with_id_flag(self):
+        """Test clear-note command with --id flag"""
+        args = self.parser.parse_args(["clear-note", "--id", "task123"])
+        self.assertEqual(args.task_id, "task123")
+
+    def test_clear_note_with_json_flag(self):
+        """Test clear-note command with --json flag"""
+        args = self.parser.parse_args(["clear-note", "Buy groceries", "--json"])
+        self.assertTrue(args.json)
+
+    def test_clear_note_alias_cn(self):
+        """Test cn alias for clear-note command"""
+        args = self.parser.parse_args(["cn", "Buy groceries"])
+        self.assertEqual(args.task_name, "Buy groceries")
+
+
+if __name__ == "__main__":
+    unittest.main()

microsoft_todo_cli-1.1.0/tests/test_note_wrapper.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+"""Unit tests for note wrapper functions"""
+
+import unittest
+from todocli.graphapi.wrapper import BASE_URL
+
+
+class TestNoteEndpointPattern(unittest.TestCase):
+    """Test that the note endpoint URL is correctly constructed"""
+
+    def test_task_endpoint_for_note_update(self):
+        """Test the task endpoint follows the expected pattern for note updates"""
+        list_id = "list123"
+        task_id = "task456"
+        endpoint = f"{BASE_URL}/{list_id}/tasks/{task_id}"
+
+        self.assertIn(list_id, endpoint)
+        self.assertIn(task_id, endpoint)
+        self.assertTrue(endpoint.startswith("https://graph.microsoft.com"))
+        self.assertIn("/tasks/", endpoint)
+
+    def test_note_request_body_format(self):
+        """Test that note request body has correct structure"""
+        note_content = "Test note content"
+        content_type = "text"
+
+        request_body = {
+            "body": {
+                "content": note_content,
+                "contentType": content_type,
+            }
+        }
+
+        self.assertIn("body", request_body)
+        self.assertEqual(request_body["body"]["content"], note_content)
+        self.assertEqual(request_body["body"]["contentType"], content_type)
+
+    def test_clear_note_request_body_format(self):
+        """Test that clear note request body has correct structure (empty content)"""
+        request_body = {
+            "body": {
+                "content": "",
+                "contentType": "text",
+            }
+        }
+
+        self.assertIn("body", request_body)
+        self.assertEqual(request_body["body"]["content"], "")
+
+
+if __name__ == "__main__":
+    unittest.main()

microsoft_todo_cli-1.1.0/todocli/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.1.0"

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.1.0}/todocli/cli.py

@@ -837,6 +837,122 @@ def rm_step(args):
         print(result["message"])
 
 
+def note(args):
+    """Add or update a note on a task."""
+    task_id = getattr(args, "task_id", None)
+    use_json = getattr(args, "json", False)
+    note_content = args.note_content
+
+    if task_id:
+        list_name = getattr(args, "list", None) or "Tasks"
+        returned_id, title, content = wrapper.update_task_note(
+            note_content=note_content,
+            list_name=list_name,
+            task_id=task_id,
+        )
+        result = {
+            "action": "updated",
+            "id": returned_id,
+            "title": title,
+            "note": content,
+            "list": list_name,
+            "message": f"Updated note on task '{title}'",
+        }
+    else:
+        task_list, task_name = parse_task_path(
+            args.task_name, getattr(args, "list", None)
+        )
+        returned_id, title, content = wrapper.update_task_note(
+            note_content=note_content,
+            list_name=task_list,
+            task_name=try_parse_as_int(task_name),
+        )
+        result = {
+            "action": "updated",
+            "id": returned_id,
+            "title": title,
+            "note": content,
+            "list": task_list,
+            "message": f"Updated note on task '{title}' in '{task_list}'",
+        }
+
+    if use_json:
+        print(json.dumps(result, indent=2))
+    else:
+        print(result["message"])
+
+
+def show_note(args):
+    """Display the note of a task."""
+    task_id = getattr(args, "task_id", None)
+    use_json = getattr(args, "json", False)
+
+    if task_id:
+        task_list = getattr(args, "list", None) or "Tasks"
+        task = wrapper.get_task(list_name=task_list, task_id=task_id)
+    else:
+        task_list, task_name = parse_task_path(
+            args.task_name, getattr(args, "list", None)
+        )
+        task = wrapper.get_task(
+            list_name=task_list, task_name=try_parse_as_int(task_name)
+        )
+
+    if use_json:
+        output = {
+            "id": task.id,
+            "title": task.title,
+            "note": task.note if task.note else None,
+            "list": task_list,
+        }
+        print(json.dumps(output, indent=2))
+    else:
+        if task.note:
+            print(task.note)
+        else:
+            print(f"No note on task '{task.title}'")
+
+
+def clear_note(args):
+    """Clear the note from a task."""
+    task_id = getattr(args, "task_id", None)
+    use_json = getattr(args, "json", False)
+
+    if task_id:
+        list_name = getattr(args, "list", None) or "Tasks"
+        returned_id, title = wrapper.clear_task_note(
+            list_name=list_name,
+            task_id=task_id,
+        )
+        result = {
+            "action": "cleared",
+            "id": returned_id,
+            "title": title,
+            "list": list_name,
+            "message": f"Cleared note from task '{title}'",
+        }
+    else:
+        task_list, task_name = parse_task_path(
+            args.task_name, getattr(args, "list", None)
+        )
+        returned_id, title = wrapper.clear_task_note(
+            list_name=task_list,
+            task_name=try_parse_as_int(task_name),
+        )
+        result = {
+            "action": "cleared",
+            "id": returned_id,
+            "title": title,
+            "list": task_list,
+            "message": f"Cleared note from task '{title}' in '{task_list}'",
+        }
+
+    if use_json:
+        print(json.dumps(result, indent=2))
+    else:
+        print(result["message"])
+
+
 def show(args):
     """Display all details of a task."""
     task_id = getattr(args, "task_id", None)
@@ -875,6 +991,8 @@ def show(args):
         if task.reminder_datetime:
             print(f"Reminder:   {task.reminder_datetime.strftime('%Y-%m-%d %H:%M')}")
         print(f"Created:    {format_date(task.created_datetime, date_fmt)}")
+        if task.note:
+            print(f"Note:       {task.note}")
         if steps:
             print("Steps:")
             for i, step in enumerate(steps):
@@ -1272,6 +1390,39 @@ def setup_parser():
     _add_json_flag(subparser)
     subparser.set_defaults(func=rm_step)
 
+    # 'note' command - add or update a note on a task
+    subparser = subparsers.add_parser("note", help="Add or update a note on a task")
+    subparser.add_argument("task_name", nargs="?", help=helptext_task_name)
+    subparser.add_argument("note_content", help="Note content to add to the task")
+    _add_list_flag(subparser)
+    _add_id_flag(subparser)
+    _add_json_flag(subparser)
+    subparser.set_defaults(func=note)
+
+    # 'show-note' command (primary) and 'sn' alias
+    for cmd_name in ["show-note", "sn"]:
+        subparser = subparsers.add_parser(
+            cmd_name,
+            help="Display the note of a task" if cmd_name == "show-note" else argparse.SUPPRESS,
+        )
+        subparser.add_argument("task_name", nargs="?", help=helptext_task_name)
+        _add_list_flag(subparser)
+        _add_id_flag(subparser)
+        _add_json_flag(subparser)
+        subparser.set_defaults(func=show_note)
+
+    # 'clear-note' command (primary) and 'cn' alias
+    for cmd_name in ["clear-note", "cn"]:
+        subparser = subparsers.add_parser(
+            cmd_name,
+            help="Clear the note from a task" if cmd_name == "clear-note" else argparse.SUPPRESS,
+        )
+        subparser.add_argument("task_name", nargs="?", help=helptext_task_name)
+        _add_list_flag(subparser)
+        _add_id_flag(subparser)
+        _add_json_flag(subparser)
+        subparser.set_defaults(func=clear_note)
+
     return parser
 
 

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.1.0}/todocli/graphapi/wrapper.py

@@ -658,3 +658,69 @@ def get_step_id(
         raise StepNotFoundByName(step_name, task_name)
     else:
         raise TypeError(f"step_name must be str or int, got {type(step_name).__name__}")
+
+
+# --- Note functions ---
+
+
+def update_task_note(
+    note_content: str,
+    list_name: str = None,
+    task_name: Union[str, int] = None,
+    list_id: str = None,
+    task_id: str = None,
+    content_type: str = "text",
+):
+    """Update the note (body) of a task. Returns (task_id, task_title, note_content)."""
+    _require_list(list_name, list_id)
+    _require_task(task_name, task_id)
+
+    if list_id is None:
+        list_id = get_list_id_by_name(list_name)
+    if task_id is None:
+        task_id = get_task_id_by_name(list_name, task_name)
+
+    endpoint = f"{BASE_URL}/{list_id}/tasks/{task_id}"
+    request_body = {
+        "body": {
+            "content": note_content,
+            "contentType": content_type,
+        }
+    }
+    session = get_oauth_session()
+    response = session.patch(endpoint, json=request_body)
+    if response.ok:
+        data = json.loads(response.content.decode())
+        body = data.get("body", {})
+        return task_id, data.get("title", ""), body.get("content", "")
+    response.raise_for_status()
+
+
+def clear_task_note(
+    list_name: str = None,
+    task_name: Union[str, int] = None,
+    list_id: str = None,
+    task_id: str = None,
+):
+    """Clear the note (body) of a task. Returns (task_id, task_title)."""
+    _require_list(list_name, list_id)
+    _require_task(task_name, task_id)
+
+    if list_id is None:
+        list_id = get_list_id_by_name(list_name)
+    if task_id is None:
+        task_id = get_task_id_by_name(list_name, task_name)
+
+    endpoint = f"{BASE_URL}/{list_id}/tasks/{task_id}"
+    request_body = {
+        "body": {
+            "content": "",
+            "contentType": "text",
+        }
+    }
+    session = get_oauth_session()
+    response = session.patch(endpoint, json=request_body)
+    if response.ok:
+        data = json.loads(response.content.decode())
+        return task_id, data.get("title", "")
+    response.raise_for_status()

{microsoft_todo_cli-1.0.0 → microsoft_todo_cli-1.1.0}/todocli/models/todotask.py

@@ -77,6 +77,14 @@ class Task:
         else:
             self.body_last_modified_datetime = None
 
+        # Note (body content)
+        if "body" in query_result and query_result["body"]:
+            self.note = query_result["body"].get("content", "")
+            self.note_content_type = query_result["body"].get("contentType", "text")
+        else:
+            self.note = ""
+            self.note_content_type = "text"
+
     def to_dict(self):
         """Convert task to dictionary for JSON serialization."""
         return {
@@ -85,6 +93,7 @@ class Task:
             "status": self.status.value,
             "importance": self.importance.value,
             "is_reminder_on": self.is_reminder_on,
+            "note": self.note if self.note else None,
             "created_datetime": (
                 self.created_datetime.isoformat() if self.created_datetime else None
             ),

microsoft_todo_cli-1.0.0/todocli/__init__.py

@@ -1 +0,0 @@
-__version__ = "1.0.0"