microsoft-todo-cli 1.0.0__tar.gz

microsoft_todo_cli-1.0.0/CHANGES.txt

@@ -0,0 +1,10 @@
+v1.0.0, 2026-02-04
+  - Fork from kiblee/tod0 with redesigned CLI
+  - Removed interactive TUI, CLI-only
+  - Added JSON output for all commands (--json flag)
+  - Added --id flag for stable task identification
+  - Added filters: --all, --completed, --due-today, --overdue, --important
+  - Added uncomplete/uncomplete-step commands
+  - Added inline step creation with -S flag
+  - Renamed commands: lists (was ls), tasks (was lst), new-list (was newl)
+  - Added command aliases: t, n, c, d

microsoft_todo_cli-1.0.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2019 kiblee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

microsoft_todo_cli-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include CHANGES.txt
+recursive-include docs *.md

microsoft_todo_cli-1.0.0/PKG-INFO

@@ -0,0 +1,296 @@
+Metadata-Version: 2.4
+Name: microsoft-todo-cli
+Version: 1.0.0
+Summary: Fast, minimal command-line client for Microsoft To-Do
+Home-page: https://github.com/underwear/microsoft-todo-cli
+Author: underwear
+Author-email: 
+License: MIT
+Keywords: microsoft todo cli task management
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml
+Requires-Dist: requests>=2.28.1
+Requires-Dist: requests_oauthlib
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# microsoft-todo-cli
+
+Fast, minimal command-line client for Microsoft To-Do
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+```
+$ todo tasks
+[0]  Buy groceries
+[1]  Call mom                     ! (due: tomorrow)
+[2]  Review PR #42
+     [x] Check tests
+     [ ] Add documentation
+
+$ todo new "Deploy v2.0" -d friday -r 9am -I
+Created task 'Deploy v2.0' in 'Tasks'
+
+$ todo complete 0
+Completed task 'Buy groceries' in 'Tasks'
+```
+
+## Install
+
+**Requirements:** Python 3.10+
+
+```bash
+pip install microsoft-todo-cli
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/underwear/microsoft-todo-cli.git
+cd microsoft-todo-cli
+pip install -e .
+```
+
+Then configure Microsoft API access: **[Setup Guide](docs/setup-api.md)** (5 min)
+
+## Quick Start
+
+```bash
+todo lists                        # Show all lists
+todo tasks                        # Show tasks from default list
+todo tasks Work                   # Show tasks from "Work" list
+todo new "Buy milk"               # Create task
+todo complete "Buy milk"          # Mark done (or: todo c "Buy milk")
+todo rm "Old task"                # Delete
+```
+
+**Default list**: The first list returned by Microsoft To-Do API (usually "Tasks"). Specify a list explicitly with `-l ListName` or as a positional argument.
+
+**Short aliases**: `t` (tasks), `n` (new), `c` (complete), `d` (rm) — see [Aliases](#aliases).
+
+## Usage
+
+### Tasks
+
+```bash
+# View
+todo tasks                        # Default list
+todo tasks Work                   # Specific list
+todo tasks --due-today            # Due today
+todo tasks --overdue              # Past due
+todo tasks --important            # High priority
+todo tasks --completed            # Done tasks
+todo tasks --all                  # Everything
+
+# Create
+todo new "Task name"              # Basic
+todo new "Task" -l Work           # In specific list
+todo new "Task" -d tomorrow       # With due date
+todo new "Task" -r 2h             # With reminder (in 2 hours)
+todo new "Task" -d mon -r 9am     # Due Monday, remind at 9am
+todo new "Task" -I                # Important
+todo new "Task" -R daily          # Recurring
+todo new "Task" -R weekly:mon,fri # Recurring on specific days
+todo new "Task" -S "Step 1" -S "Step 2"  # With subtasks
+
+# View single task
+todo show "Task"                  # Show task details
+todo show 0                       # Show by index
+
+# Manage
+todo complete "Task"              # Mark complete
+todo complete 0 1 2               # Complete by index (batch)
+todo uncomplete "Task"            # Reopen task
+todo update "Task" --title "New"  # Rename
+todo update "Task" -d friday -I   # Change due date, make important
+todo rm "Task"                    # Delete (asks confirmation)
+todo rm "Task" -y                 # Delete (no confirmation)
+```
+
+### Subtasks (Steps)
+
+```bash
+todo new-step "Task" "Step text"      # Add step
+todo list-steps "Task"                # List steps
+todo complete-step "Task" "Step"      # Check off
+todo uncomplete-step "Task" "Step"    # Uncheck
+todo rm-step "Task" 0                 # Remove by index
+```
+
+### Lists
+
+```bash
+todo lists                        # Show all lists
+todo new-list "Project X"         # Create list
+todo rename-list "Old" "New"      # Rename list
+todo rm-list "Project X"          # Delete list (asks confirmation)
+todo rm-list "Project X" -y       # Delete list (no confirmation)
+```
+
+### Date & Time Formats
+
+| Type | Examples |
+|------|----------|
+| Relative | `1h`, `30m`, `2d`, `1h30m` |
+| Time | `9:30`, `9am`, `17:00`, `5:30pm` |
+| Days | `tomorrow`, `monday`, `fri` |
+| Date | `2026-12-31`, `31.12.2026`, `12/31/2026` |
+| Keywords | `morning` (7:00), `evening` (18:00) |
+
+### Recurrence Patterns
+
+| Pattern | Description |
+|---------|-------------|
+| `daily` | Every day |
+| `weekly` | Every week |
+| `monthly` | Every month |
+| `yearly` | Every year |
+| `weekdays` | Monday to Friday |
+| `weekly:mon,wed,fri` | Specific days |
+| `every 2 days` | Custom interval |
+| `every 3 weeks` | Custom interval |
+
+## Scripting & Automation
+
+### JSON Output
+
+Add `--json` to any command for machine-readable output:
+
+```bash
+todo tasks --json
+todo lists --json
+todo show "Task" --json
+```
+
+**Example: `todo tasks --json`**
+```json
+{
+  "list": "Tasks",
+  "tasks": [
+    {
+      "id": "AAMkADU3...",
+      "title": "Buy groceries",
+      "status": "notStarted",
+      "importance": "normal",
+      "due_date": null,
+      "reminder": null,
+      "recurrence": null,
+      "steps": []
+    },
+    {
+      "id": "AAMkADU4...",
+      "title": "Call mom",
+      "status": "notStarted",
+      "importance": "high",
+      "due_date": "2026-02-06",
+      "reminder": "2026-02-06T09:00:00",
+      "recurrence": null,
+      "steps": [
+        {"id": "step1", "name": "Check tests", "completed": true},
+        {"id": "step2", "name": "Add documentation", "completed": false}
+      ]
+    }
+  ]
+}
+```
+
+**Write commands return action confirmation:**
+```bash
+todo new "Task" --json            # {"action": "created", "id": "AAMk...", "title": "Task", "list": "Tasks"}
+todo complete "Task" --json       # {"action": "completed", "id": "AAMk...", "title": "Task", "list": "Tasks"}
+todo rm "Task" -y --json          # {"action": "removed", "id": "AAMk...", "title": "Task", "list": "Tasks"}
+```
+
+### Task Identification
+
+Tasks can be identified by **name**, **index**, or **ID**. Priority for reliable automation:
+
+| Method | Stability | Use case |
+|--------|-----------|----------|
+| `--id "AAMk..."` | Stable | Scripts, automation, agents |
+| Index (`0`, `1`) | Unstable | Interactive use only |
+| Name (`"Task"`) | Unstable | Interactive use, unique names |
+
+```bash
+# Get task ID from JSON output
+todo tasks --json | jq -r '.tasks[0].id'
+
+# Show IDs inline (human-readable + IDs)
+todo tasks --show-id
+
+# Use ID in commands (requires -l for list context)
+todo complete --id "AAMkADU3..." -l Tasks
+todo update --id "AAMkADU3..." --title "New title"
+todo rm --id "AAMkADU3..." -l Tasks -y
+```
+
+**Example: Create and complete a task by ID**
+```bash
+ID=$(todo new "Deploy v2.0" -l Work --json | jq -r '.id')
+# ... later ...
+todo complete --id "$ID" -l Work
+```
+
+### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | General error (invalid arguments, task not found, API error) |
+
+With `--json`: stdout contains only valid JSON on success. Errors go to stderr.
+
+### Tips for Scripts and Agents
+
+- **Prefer `--id` over names/indexes**: Names can have duplicates (first match wins). Indexes change as tasks are added/completed/reordered.
+- **Always use `-l ListName`** with `--id` to specify list context.
+- **Capture IDs on creation**: Store the ID from `todo new --json` for later operations.
+- **Use `--json` for parsing**: Human-readable output format may change between versions.
+- **Use `-y` flag** with `rm` commands to skip confirmation prompts.
+
+## Aliases
+
+| Alias | Command | Alias | Command |
+|-------|---------|-------|---------|
+| `t` | `tasks` | `d` | `rm` |
+| `n` | `new` | `newl` | `new-list` |
+| `c` | `complete` | `reopen` | `uncomplete` |
+
+```bash
+todo t                  # = todo tasks
+todo n "Task" -d fri    # = todo new "Task" -d fri
+todo c 0 1 2            # = todo complete 0 1 2
+todo d "Old" -y         # = todo rm "Old" -y
+```
+
+## Credits
+
+Forked from [kiblee/tod0](https://github.com/kiblee/tod0) with a redesigned CLI.
+
+## License
+
+MIT

microsoft_todo_cli-1.0.0/README.md

@@ -0,0 +1,258 @@
+# microsoft-todo-cli
+
+Fast, minimal command-line client for Microsoft To-Do
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+```
+$ todo tasks
+[0]  Buy groceries
+[1]  Call mom                     ! (due: tomorrow)
+[2]  Review PR #42
+     [x] Check tests
+     [ ] Add documentation
+
+$ todo new "Deploy v2.0" -d friday -r 9am -I
+Created task 'Deploy v2.0' in 'Tasks'
+
+$ todo complete 0
+Completed task 'Buy groceries' in 'Tasks'
+```
+
+## Install
+
+**Requirements:** Python 3.10+
+
+```bash
+pip install microsoft-todo-cli
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/underwear/microsoft-todo-cli.git
+cd microsoft-todo-cli
+pip install -e .
+```
+
+Then configure Microsoft API access: **[Setup Guide](docs/setup-api.md)** (5 min)
+
+## Quick Start
+
+```bash
+todo lists                        # Show all lists
+todo tasks                        # Show tasks from default list
+todo tasks Work                   # Show tasks from "Work" list
+todo new "Buy milk"               # Create task
+todo complete "Buy milk"          # Mark done (or: todo c "Buy milk")
+todo rm "Old task"                # Delete
+```
+
+**Default list**: The first list returned by Microsoft To-Do API (usually "Tasks"). Specify a list explicitly with `-l ListName` or as a positional argument.
+
+**Short aliases**: `t` (tasks), `n` (new), `c` (complete), `d` (rm) — see [Aliases](#aliases).
+
+## Usage
+
+### Tasks
+
+```bash
+# View
+todo tasks                        # Default list
+todo tasks Work                   # Specific list
+todo tasks --due-today            # Due today
+todo tasks --overdue              # Past due
+todo tasks --important            # High priority
+todo tasks --completed            # Done tasks
+todo tasks --all                  # Everything
+
+# Create
+todo new "Task name"              # Basic
+todo new "Task" -l Work           # In specific list
+todo new "Task" -d tomorrow       # With due date
+todo new "Task" -r 2h             # With reminder (in 2 hours)
+todo new "Task" -d mon -r 9am     # Due Monday, remind at 9am
+todo new "Task" -I                # Important
+todo new "Task" -R daily          # Recurring
+todo new "Task" -R weekly:mon,fri # Recurring on specific days
+todo new "Task" -S "Step 1" -S "Step 2"  # With subtasks
+
+# View single task
+todo show "Task"                  # Show task details
+todo show 0                       # Show by index
+
+# Manage
+todo complete "Task"              # Mark complete
+todo complete 0 1 2               # Complete by index (batch)
+todo uncomplete "Task"            # Reopen task
+todo update "Task" --title "New"  # Rename
+todo update "Task" -d friday -I   # Change due date, make important
+todo rm "Task"                    # Delete (asks confirmation)
+todo rm "Task" -y                 # Delete (no confirmation)
+```
+
+### Subtasks (Steps)
+
+```bash
+todo new-step "Task" "Step text"      # Add step
+todo list-steps "Task"                # List steps
+todo complete-step "Task" "Step"      # Check off
+todo uncomplete-step "Task" "Step"    # Uncheck
+todo rm-step "Task" 0                 # Remove by index
+```
+
+### Lists
+
+```bash
+todo lists                        # Show all lists
+todo new-list "Project X"         # Create list
+todo rename-list "Old" "New"      # Rename list
+todo rm-list "Project X"          # Delete list (asks confirmation)
+todo rm-list "Project X" -y       # Delete list (no confirmation)
+```
+
+### Date & Time Formats
+
+| Type | Examples |
+|------|----------|
+| Relative | `1h`, `30m`, `2d`, `1h30m` |
+| Time | `9:30`, `9am`, `17:00`, `5:30pm` |
+| Days | `tomorrow`, `monday`, `fri` |
+| Date | `2026-12-31`, `31.12.2026`, `12/31/2026` |
+| Keywords | `morning` (7:00), `evening` (18:00) |
+
+### Recurrence Patterns
+
+| Pattern | Description |
+|---------|-------------|
+| `daily` | Every day |
+| `weekly` | Every week |
+| `monthly` | Every month |
+| `yearly` | Every year |
+| `weekdays` | Monday to Friday |
+| `weekly:mon,wed,fri` | Specific days |
+| `every 2 days` | Custom interval |
+| `every 3 weeks` | Custom interval |
+
+## Scripting & Automation
+
+### JSON Output
+
+Add `--json` to any command for machine-readable output:
+
+```bash
+todo tasks --json
+todo lists --json
+todo show "Task" --json
+```
+
+**Example: `todo tasks --json`**
+```json
+{
+  "list": "Tasks",
+  "tasks": [
+    {
+      "id": "AAMkADU3...",
+      "title": "Buy groceries",
+      "status": "notStarted",
+      "importance": "normal",
+      "due_date": null,
+      "reminder": null,
+      "recurrence": null,
+      "steps": []
+    },
+    {
+      "id": "AAMkADU4...",
+      "title": "Call mom",
+      "status": "notStarted",
+      "importance": "high",
+      "due_date": "2026-02-06",
+      "reminder": "2026-02-06T09:00:00",
+      "recurrence": null,
+      "steps": [
+        {"id": "step1", "name": "Check tests", "completed": true},
+        {"id": "step2", "name": "Add documentation", "completed": false}
+      ]
+    }
+  ]
+}
+```
+
+**Write commands return action confirmation:**
+```bash
+todo new "Task" --json            # {"action": "created", "id": "AAMk...", "title": "Task", "list": "Tasks"}
+todo complete "Task" --json       # {"action": "completed", "id": "AAMk...", "title": "Task", "list": "Tasks"}
+todo rm "Task" -y --json          # {"action": "removed", "id": "AAMk...", "title": "Task", "list": "Tasks"}
+```
+
+### Task Identification
+
+Tasks can be identified by **name**, **index**, or **ID**. Priority for reliable automation:
+
+| Method | Stability | Use case |
+|--------|-----------|----------|
+| `--id "AAMk..."` | Stable | Scripts, automation, agents |
+| Index (`0`, `1`) | Unstable | Interactive use only |
+| Name (`"Task"`) | Unstable | Interactive use, unique names |
+
+```bash
+# Get task ID from JSON output
+todo tasks --json | jq -r '.tasks[0].id'
+
+# Show IDs inline (human-readable + IDs)
+todo tasks --show-id
+
+# Use ID in commands (requires -l for list context)
+todo complete --id "AAMkADU3..." -l Tasks
+todo update --id "AAMkADU3..." --title "New title"
+todo rm --id "AAMkADU3..." -l Tasks -y
+```
+
+**Example: Create and complete a task by ID**
+```bash
+ID=$(todo new "Deploy v2.0" -l Work --json | jq -r '.id')
+# ... later ...
+todo complete --id "$ID" -l Work
+```
+
+### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | General error (invalid arguments, task not found, API error) |
+
+With `--json`: stdout contains only valid JSON on success. Errors go to stderr.
+
+### Tips for Scripts and Agents
+
+- **Prefer `--id` over names/indexes**: Names can have duplicates (first match wins). Indexes change as tasks are added/completed/reordered.
+- **Always use `-l ListName`** with `--id` to specify list context.
+- **Capture IDs on creation**: Store the ID from `todo new --json` for later operations.
+- **Use `--json` for parsing**: Human-readable output format may change between versions.
+- **Use `-y` flag** with `rm` commands to skip confirmation prompts.
+
+## Aliases
+
+| Alias | Command | Alias | Command |
+|-------|---------|-------|---------|
+| `t` | `tasks` | `d` | `rm` |
+| `n` | `new` | `newl` | `new-list` |
+| `c` | `complete` | `reopen` | `uncomplete` |
+
+```bash
+todo t                  # = todo tasks
+todo n "Task" -d fri    # = todo new "Task" -d fri
+todo c 0 1 2            # = todo complete 0 1 2
+todo d "Old" -y         # = todo rm "Old" -y
+```
+
+## Credits
+
+Forked from [kiblee/tod0](https://github.com/kiblee/tod0) with a redesigned CLI.
+
+## License
+
+MIT

microsoft_todo_cli-1.0.0/docs/setup-api.md

@@ -0,0 +1,67 @@
+# Setting Up Microsoft API Access
+
+To use `todo`, you need to register an application in Microsoft Azure to get API credentials.
+
+## Step 1: Register an Application
+
+1. Sign in to the [Azure Portal](https://portal.azure.com/)
+2. Navigate to **Microsoft Entra ID** (formerly Azure Active Directory)
+3. Click **Add** → **App registration**
+
+## Step 2: Configure the Application
+
+Fill in the registration form:
+
+| Field | Value |
+|-------|-------|
+| **Name** | `todo-cli` (or any name you prefer) |
+| **Supported account types** | Accounts in any organizational directory and personal Microsoft accounts |
+| **Redirect URI** | Platform: `Web`, URI: `https://localhost/login/authorized` |
+
+Click **Register**.
+
+## Step 3: Note Your Client ID
+
+After registration, you'll see the **Application (client) ID** on the overview page. Copy this value.
+
+## Step 4: Create a Client Secret
+
+1. In the left menu, click **Certificates & secrets**
+2. Click **New client secret**
+3. Add a description (e.g., "todo-cli") and choose an expiration
+4. Click **Add**
+5. **Important:** Copy the secret **Value** immediately (not the Secret ID). It won't be visible again.
+
+## Step 5: Configure todo
+
+Create the config file:
+
+```bash
+mkdir -p ~/.config/tod0
+```
+
+Add your credentials to `~/.config/tod0/keys.yml`:
+
+```yaml
+client_id: 'your-application-client-id'
+client_secret: 'your-client-secret-value'
+```
+
+## Step 6: First Run
+
+Run any command to trigger OAuth login:
+
+```bash
+todo lists
+```
+
+A browser window will open for Microsoft authentication. After logging in, you're ready to use the CLI.
+
+## Troubleshooting
+
+**"AADSTS50011: The redirect URI specified in the request does not match"**
+- Ensure the redirect URI is exactly `https://localhost/login/authorized`
+- Check that platform is set to `Web`
+
+**Token expired**
+- Delete `~/.config/tod0/token.pkl` and run any command to re-authenticate