td-task 0.2.4__tar.gz → 0.2.6__tar.gz

td_task-0.2.6/.github/workflows/pages.yml

@@ -0,0 +1,50 @@
+name: Publish homepage
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - index.html
+      - website/**
+      - assets/demo.gif
+      - .github/workflows/pages.yml
+
+permissions:
+  contents: read
+
+concurrency:
+  group: github-pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Stage public files
+        run: |
+          mkdir -p _site/assets
+          cp index.html _site/
+          cp -R website _site/website
+          cp assets/demo.gif _site/assets/
+
+      - name: Upload site
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: _site
+
+      - name: Deploy
+        id: deployment
+        uses: actions/deploy-pages@v4

{td_task-0.2.4 → td_task-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: td-task
-Version: 0.2.4
+Version: 0.2.6
 Summary: Fast TUI and CLI manager for tasks and Markdown notes
 Requires-Python: >=3.14
 Requires-Dist: cryptography>=42.0.0
@@ -66,6 +66,8 @@ td [command] [--list <name>]
 | `td archive` | Open the archive screen |
 | `td export [file]` | Export database to JSON (stdout if no file) |
 | `td import <file>` | Merge a JSON backup into the database |
+| `td backup github [repo]` | Encrypt and upload a backup to a private GitHub repo |
+| `td restore github [repo]` | Download and restore an encrypted GitHub backup |
 | `td update` | Upgrade to the latest version |
 | `td --version` | Print the installed version |
 | `td --help` | Print the help menu |
@@ -110,6 +112,9 @@ td notes delete 12 --json
 
 ## TUI Keybindings
 
+The TUI redraws automatically when you resize the terminal, keeping the current
+selection and unsaved edits. Help supports arrow-key and PageUp/PageDown scrolling.
+
 ### Tasks
 
 | Key | Action |
@@ -121,6 +126,7 @@ td notes delete 12 --json
 | `d` | Delete selected task |
 | `Space` | Toggle done / active |
 | `s` | Star task (pin to top, bold yellow) |
+| `S` | Cycle task sort: A-Z / Z-A / original order |
 | `c` | Archive all completed tasks |
 | `y` | Copy task list to clipboard |
 | `f` | Filter notes by title in current list; submit empty query to clear |
@@ -203,7 +209,8 @@ marker. Press `Enter` or `Backspace` on an empty continuation to leave list mode
 | `q` / `Esc` | Return |
 
 Settings you can change: max tasks per list (3–50), max starred tasks, whole-database
-encryption, current-list encryption, and backup export / import.
+encryption, current-list encryption, backup export / import, GitHub backup repo,
+GitHub backup now, auto-sync, and GitHub backup encryption.
 
 ## Agent-friendly
 
@@ -288,9 +295,42 @@ td export > backup.json
 
 # restore on another machine
 td import backup.json
+
+# encrypt and upload to a private GitHub repo (creates td-backup if missing)
+td backup github --save-password
+td backup github lucaspon/my-td-backup --save-password
+
+# optional: store plain JSON instead of an encrypted backup
+td backup github --no-encrypt
+
+# restore and merge from GitHub
+td restore github
 ```
 
 You can encrypt the whole database or only the current list from settings (`/`).
 Each encrypted list uses its own password-derived key. Tasks and note bodies stay
 encrypted in JSON backups. Whole-database and per-list encryption cannot run
 together. If you forget a password, there is no recovery.
+
+By default, GitHub backups add a separate password-based encryption layer around
+the full JSON export. In encrypted mode, `td` sends only the encrypted envelope
+to GitHub. The `gh` CLI must be
+installed and authenticated. `td backup github` creates the target repository as
+private when it does not exist, and refuses to write to a public repository.
+
+Auto-sync uses `~/.config/td/config.toml`:
+
+```toml
+[github_backup]
+auto_sync = true
+repo = "owner/td-backup"
+encrypt = true
+```
+
+Auto-sync runs after TUI sessions and CLI writes. Encrypted auto-sync needs a
+password saved in macOS Keychain with `td backup github --save-password`.
+Set `encrypt = false` to
+store plain JSON. The repository remains private, but GitHub can then read the
+backup. Encrypted mode remains the default. `td` stores a digest of the last
+successful export and skips the GitHub update when the data has not changed.
+Manual backups update the same digest.

{td_task-0.2.4 → td_task-0.2.6}/README.md

@@ -55,6 +55,8 @@ td [command] [--list <name>]
 | `td archive` | Open the archive screen |
 | `td export [file]` | Export database to JSON (stdout if no file) |
 | `td import <file>` | Merge a JSON backup into the database |
+| `td backup github [repo]` | Encrypt and upload a backup to a private GitHub repo |
+| `td restore github [repo]` | Download and restore an encrypted GitHub backup |
 | `td update` | Upgrade to the latest version |
 | `td --version` | Print the installed version |
 | `td --help` | Print the help menu |
@@ -99,6 +101,9 @@ td notes delete 12 --json
 
 ## TUI Keybindings
 
+The TUI redraws automatically when you resize the terminal, keeping the current
+selection and unsaved edits. Help supports arrow-key and PageUp/PageDown scrolling.
+
 ### Tasks
 
 | Key | Action |
@@ -110,6 +115,7 @@ td notes delete 12 --json
 | `d` | Delete selected task |
 | `Space` | Toggle done / active |
 | `s` | Star task (pin to top, bold yellow) |
+| `S` | Cycle task sort: A-Z / Z-A / original order |
 | `c` | Archive all completed tasks |
 | `y` | Copy task list to clipboard |
 | `f` | Filter notes by title in current list; submit empty query to clear |
@@ -192,7 +198,8 @@ marker. Press `Enter` or `Backspace` on an empty continuation to leave list mode
 | `q` / `Esc` | Return |
 
 Settings you can change: max tasks per list (3–50), max starred tasks, whole-database
-encryption, current-list encryption, and backup export / import.
+encryption, current-list encryption, backup export / import, GitHub backup repo,
+GitHub backup now, auto-sync, and GitHub backup encryption.
 
 ## Agent-friendly
 
@@ -277,9 +284,42 @@ td export > backup.json
 
 # restore on another machine
 td import backup.json
+
+# encrypt and upload to a private GitHub repo (creates td-backup if missing)
+td backup github --save-password
+td backup github lucaspon/my-td-backup --save-password
+
+# optional: store plain JSON instead of an encrypted backup
+td backup github --no-encrypt
+
+# restore and merge from GitHub
+td restore github
 ```
 
 You can encrypt the whole database or only the current list from settings (`/`).
 Each encrypted list uses its own password-derived key. Tasks and note bodies stay
 encrypted in JSON backups. Whole-database and per-list encryption cannot run
 together. If you forget a password, there is no recovery.
+
+By default, GitHub backups add a separate password-based encryption layer around
+the full JSON export. In encrypted mode, `td` sends only the encrypted envelope
+to GitHub. The `gh` CLI must be
+installed and authenticated. `td backup github` creates the target repository as
+private when it does not exist, and refuses to write to a public repository.
+
+Auto-sync uses `~/.config/td/config.toml`:
+
+```toml
+[github_backup]
+auto_sync = true
+repo = "owner/td-backup"
+encrypt = true
+```
+
+Auto-sync runs after TUI sessions and CLI writes. Encrypted auto-sync needs a
+password saved in macOS Keychain with `td backup github --save-password`.
+Set `encrypt = false` to
+store plain JSON. The repository remains private, but GitHub can then read the
+backup. Encrypted mode remains the default. `td` stores a digest of the last
+successful export and skips the GitHub update when the data has not changed.
+Manual backups update the same digest.

td_task-0.2.6/index.html

@@ -0,0 +1,78 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="theme-color" content="#141414">
+    <meta name="description" content="td: tasks and Markdown notes in your terminal.">
+    <meta property="og:type" content="website">
+    <meta property="og:title" content="td">
+    <meta property="og:description" content="Tasks and Markdown notes in your terminal.">
+    <title>td — terminal tasks and notes</title>
+    <link rel="icon" href="website/favicon.svg" type="image/svg+xml">
+    <link rel="stylesheet" href="website/style.css">
+    <script src="website/main.js" defer></script>
+  </head>
+  <body>
+    <a class="skip-link" href="#main">Skip to content</a>
+    <div class="page">
+      <header>
+        <p>td — tasks and Markdown notes in your terminal.</p>
+      </header>
+
+      <main id="main">
+        <ul class="features" aria-label="Features">
+          <li>Multiple lists and keyboard navigation.</li>
+          <li>Markdown notes with a built-in editor.</li>
+          <li>Optional database and list encryption.</li>
+          <li>JSON export and a scriptable CLI.</li>
+        </ul>
+        <figure>
+          <a href="assets/demo.gif" aria-label="Open the demo GIF at full size">
+            <img src="assets/demo.gif" width="680" height="360" alt="Demo of td: adding tasks, starring priorities, and switching lists with the keyboard." fetchpriority="high">
+          </a>
+        </figure>
+
+        <section id="install" aria-label="Installation and usage">
+          <dl class="commands">
+            <div>
+              <dt>install (uv)</dt>
+              <dd>
+                <code>uv tool install td-task</code>
+                <button type="button" data-copy="uv tool install td-task" aria-label="Copy uv install command" hidden>[copy]</button>
+              </dd>
+            </div>
+            <div>
+              <dt>or pip</dt>
+              <dd>
+                <code>pip install td-task</code>
+                <button type="button" data-copy="pip install td-task" aria-label="Copy pip install command" hidden>[copy]</button>
+              </dd>
+            </div>
+            <div>
+              <dt>run</dt>
+              <dd>
+                <code>td</code>
+                <button type="button" data-copy="td" aria-label="Copy td launch command" hidden>[copy]</button>
+              </dd>
+            </div>
+            <div>
+              <dt>or uvx</dt>
+              <dd>
+                <code>uvx td-task</code>
+                <button type="button" data-copy="uvx td-task" aria-label="Copy run without installing command" hidden>[copy]</button>
+              </dd>
+            </div>
+          </dl>
+          <p class="requirement">Python 3.14+. <a href="https://docs.astral.sh/uv/getting-started/installation/">uv docs</a>.</p>
+          <p class="copy-status" role="status" aria-live="polite"></p>
+        </section>
+      </main>
+
+      <footer>
+        <a href="https://github.com/lucaspon/td">github.com/lucaspon/td</a>
+        <a href="https://twitter.com/lucasponn">@lucasponn</a>
+      </footer>
+    </div>
+  </body>
+</html>

{td_task-0.2.4 → td_task-0.2.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "td-task"
-version = "0.2.4"
+version = "0.2.6"
 description = "Fast TUI and CLI manager for tasks and Markdown notes"
 readme = "README.md"
 requires-python = ">=3.14"

{td_task-0.2.4 → td_task-0.2.6}/src/td/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.2.6] - 2026-11-04
+- Back up and restore data through private GitHub repositories using the gh CLI.
+- Encrypt backups by default, with optional plain JSON storage.
+- Add configurable auto-sync that skips unchanged data and supports macOS Keychain passwords.
+- Add Sync settings, backup progress screens, and a link to open the GitHub repository.
+- Support backups to new and existing empty repositories.
+
+## [0.2.5] - 2026-11-04
+- Redraw automatically when terminal dimensions change, without waiting for a keypress.
+- Preserve selection, unsaved edits, note cursor, and confirmations while resizing.
+- Fit frames to smaller windows and reflow note content when the terminal grows.
+- Scroll help with arrow keys and PageUp/PageDown.
+
 ## [0.2.4] - 2026-08-05
 - Add live, case-insensitive note-title filtering with `f` in the current list.
 

{td_task-0.2.4 → td_task-0.2.6}/src/td/__main__.py

@@ -72,6 +72,10 @@ def main() -> None:
             _run_export(args)
         elif len(args) > 1 and args[1] in ("import", "-import", "--import"):
             _run_import(args)
+        elif len(args) > 1 and args[1] in ("backup", "-backup", "--backup"):
+            _run_backup(args)
+        elif len(args) > 1 and args[1] in ("restore", "-restore", "--restore"):
+            _run_restore(args)
         else:
             from . import db
             lists = db.get_all_lists()
@@ -123,6 +127,8 @@ def _run_help() -> None:
     commands_table.add_row("  archive", "Open TUI directly in the completed archive screen")
     commands_table.add_row("  export [file]", "Export database to JSON file or print to stdout")
     commands_table.add_row("  import <file>", "Import and merge database records from a JSON file")
+    commands_table.add_row("  backup github [repo]", "Encrypt and upload a backup to a private GitHub repo")
+    commands_table.add_row("  restore github [repo]", "Download and restore an encrypted GitHub backup")
     commands_table.add_row("  update", "Upgrade the `td` package to the latest version")
     
     console.print(commands_table)
@@ -136,6 +142,8 @@ def _run_help() -> None:
     
     options_table.add_row("  -l, --list <name>", "Specify/create list context (TUI list-lock, CLI scope)")
     options_table.add_row("  --dev", "Watch source code directory and restart interactive TUI on changes")
+    options_table.add_row("  --no-encrypt", "Store a GitHub backup as plain JSON (private repo required)")
+    options_table.add_row("  --save-password", "Save encrypted backup password in macOS Keychain for auto-sync")
     options_table.add_row("  -h, --help", "Print this detailed, LLM-friendly help menu and exit")
     
     console.print(options_table)
@@ -256,6 +264,7 @@ def _run_notes(list_name: str, has_list: bool, args: list[str]) -> None:
             print(json.dumps(note, indent=2))
         else:
             print(f"✓ Note added to '{list_name}' (note ID: {note['id']}, task ID: {note['task_id']})")
+        _auto_sync()
         return
 
     if action == "list":
@@ -315,6 +324,7 @@ def _run_notes(list_name: str, has_list: bool, args: list[str]) -> None:
             print(json.dumps(updated, indent=2))
         else:
             print(f"✓ Note {note_id} updated.")
+        _auto_sync()
         return
 
     deleted = db.delete_note(note_id)
@@ -322,6 +332,7 @@ def _run_notes(list_name: str, has_list: bool, args: list[str]) -> None:
         print(json.dumps({"id": note_id, "deleted": deleted}))
     else:
         print(f"✓ Note {note_id} deleted.")
+    _auto_sync()
 
 
 def _run_add(list_name: str, args: list[str]) -> None:
@@ -338,6 +349,7 @@ def _run_add(list_name: str, args: list[str]) -> None:
         print("✗ Failed to add task (maximum active tasks reached).")
         sys.exit(1)
     print(f"✓ Task added successfully to list '{list_name}' (ID: {result['id']})")
+    _auto_sync()
 
 
 def _run_list(list_name: str) -> None:
@@ -571,10 +583,98 @@ def _run_import(args: list[str]) -> None:
             json_str = f.read()
         db.import_from_json(json_str)
         print(f"✓ Database successfully imported and merged from {filepath}")
+        _auto_sync()
     except Exception as e:
         print(f"✗ Import failed: {e}")
         sys.exit(1)
 
 
+def _github_backup_repo(args: list[str]) -> str:
+    repo = _option_value(args, "--repo")
+    if repo is None and len(args) > 3 and not args[3].startswith("-"):
+        repo = args[3]
+    return (repo or "td-backup").strip()
+
+
+def _backup_password(*, confirm: bool) -> str:
+    import getpass
+
+    try:
+        password = getpass.getpass("Backup password: ")
+        if confirm:
+            repeated = getpass.getpass("Confirm backup password: ")
+            if password != repeated:
+                raise ValueError("Backup passwords do not match")
+        if not password:
+            raise ValueError("Backup password cannot be empty")
+        return password
+    except (KeyboardInterrupt, EOFError):
+        print("\nCancelled.")
+        sys.exit(0)
+
+
+def _auto_sync() -> None:
+    from . import backup, config, db
+
+    try:
+        repo = backup.sync_if_configured(db.export_to_json())
+        if repo:
+            print(
+                f"✓ auto-synced backup to {repo}/{backup.BACKUP_FILENAME}",
+                file=sys.stderr,
+            )
+    except Exception as error:
+        print(f"✗ auto-sync failed: {error}", file=sys.stderr)
+
+
+def _run_backup(args: list[str]) -> None:
+    if len(args) < 3 or args[2] != "github":
+        print("Usage: td backup github [repo|--repo <owner/name>] [--no-encrypt] [--save-password]")
+        sys.exit(1)
+
+    from . import backup, config, db
+
+    _cli_ensure_unlocked()
+    try:
+        repo_name = _github_backup_repo(args)
+        should_encrypt = "--no-encrypt" not in args
+        if not should_encrypt and "--save-password" in args:
+            raise ValueError("--save-password requires encrypted backup mode")
+        password = _backup_password(confirm=True) if should_encrypt else None
+        data = db.export_to_json()
+        payload = backup.encrypt_backup(data, password) if password else data
+        repo = backup.upload_backup(repo_name, payload)
+        config.set_github_backup(
+            repo=repo,
+            last_sync_digest=backup.backup_digest(data, should_encrypt),
+        )
+        if password and "--save-password" in args:
+            backup.store_password(repo, password)
+        mode = "encrypted" if password else "unencrypted"
+        print(f"✓ {mode} backup uploaded to {repo}/{backup.BACKUP_FILENAME}")
+    except Exception as error:
+        print(f"✗ GitHub backup failed: {error}")
+        sys.exit(1)
+
+
+def _run_restore(args: list[str]) -> None:
+    if len(args) < 3 or args[2] != "github":
+        print("Usage: td restore github [repo|--repo <owner/name>]")
+        sys.exit(1)
+
+    from . import backup, db
+
+    _cli_ensure_unlocked()
+    try:
+        payload = backup.download_backup(_github_backup_repo(args))
+        password = _backup_password(confirm=False) if backup.is_encrypted_backup(payload) else None
+        db.import_from_json(backup.decode_backup(payload, password))
+        mode = "encrypted" if password else "unencrypted"
+        print(f"✓ {mode} GitHub backup restored and merged")
+    except Exception as error:
+        print(f"✗ GitHub restore failed: {error}")
+        sys.exit(1)
+
+
 if __name__ == "__main__":
     main()