Skip to main content

easydone - Task Tracker App

A focused command-line task manager for turning a messy to-do list into a clear next action.

easydone is a lightweight Python CLI for creating, updating, completing, deleting, and filtering tasks directly from your terminal. Tasks are saved as readable JSON, and the storage layer now includes automatic backups, corruption quarantine, and atomic writes to keep your data safe.

Why easydone?

  • Fast terminal-first workflow
  • Statuses for work in motion: not-done, in-progress, and done
  • Four priority levels: low, normal, high, and urgent
  • Filter tasks by status, priority, or both
  • Human-readable JSON storage with no database setup
  • Bulletproof data handling: atomic writes, automatic .bak backups, and quarantine of corrupted files
  • Pretty terminal output with Rich (falls back to plain text if unavailable)

Project Structure

easydone/
├── easydone/
│   ├── __init__.py   # Package metadata (version, etc.)
│   ├── __main__.py   # Application entry point
│   ├── cli.py        # Argument parser and command dispatch
│   ├── logic.py      # Task-management operations
│   ├── storage.py    # JSON loading/saving with backup & quarantine
│   └── format.py     # Output formatting (Rich / plain)
├── tests/
│   ├── test_cli.py
│   ├── test_logic.py
│   ├── test_storage.py
│   └── test_format.py
├── LICENSE
├── pyproject.toml    # Packaging and pytest configuration
└── README.md

Quick Start

Requirements

  • Python 3.9 or newer
  • Windows PowerShell, macOS, or Linux terminal

From the project root, create a virtual environment and install easydone in editable mode:

py -m venv .venv
.\.venv\Scripts\Activate.ps1
py -m pip install -e .

On macOS or Linux:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .

Or install directly from PyPI:

py -m pip install easydone

You can now run the application:

easydone

To see all available commands:

easydone --help

Everyday Workflow

Create a task:

easydone new "Read a book"

Create a task with a status and priority:

easydone new "Finish project report" --status in-progress --priority high

List everything:

easydone list

Focus on urgent unfinished work:

easydone list --status not-done --priority urgent

Mark a task as complete:

easydone mark 123 done

Command Reference

new

Create a task. The description is required.

easydone new DESCRIPTION [--status STATUS] [--priority PRIORITY]

Options:

  • -s, --status: not-done, done, or in-progress; defaults to not-done
  • -p, --priority: low, normal, high, or urgent; defaults to low

update

Change the description and/or priority of an existing task.
The --priority option now validates against the four allowed values.

easydone update TASK_ID [--description NEW_DESCRIPTION] [--priority NEW_PRIORITY]

Examples:

easydone update 123 --description "Read a novel"
easydone update 123 --priority high

mark

Change the status of an existing task.

easydone mark TASK_ID new-status

delete

Delete one or more existing tasks. easydone tasks for confirmation for each ID unless -f or --forced is used.

easydone delete TASK_ID [TASK_ID ...]
easydone delete TASK_ID [TASK_ID ...] --forced

If you supply multiple IDs, all of them are validated before any deletion occurs. If any ID is invalid, the entire operation is aborted and no tasks are removed.

list

List all tasks or filter them by status and priority. You can omit dates with the --no-dates option.

easydone list [--status STATUS] [--priority PRIORITY] [--no-dates]

When both filters are supplied, a task must match both of them.

Data Storage

easydone stores task data in a user‑scoped application directory so it does not depend on where the command is launched from.

  • Windows: %APPDATA%\easydone\tasks.json
  • macOS: ~/Library/Application Support/easydone/tasks.json
  • Linux: ~/.local/share/easydone/tasks.json

The app writes a small metadata wrapper with the file schema version and the version of easydone that saved it. This makes future upgrades safer and compatibility warnings explicit.

{
    "schema_version": 1,
    "app_version": "0.2.0",
    "saved_at": "2026-08-28",
    "tasks": {
        "123": {
            "description": "Finish project report",
            "status": "in-progress",
            "priority": "high",
            "created-at": "2026-08-28",
            "updated-at": null
        }
    }
}

Safety & Recovery

easydone now protects your data in three ways:

  1. Atomic writes: Every save writes to a temporary file first, then swaps it atomically. A crash mid‑write never leaves a half‑written file.
  2. Automatic backups: Before every save, the current tasks.json is copied to tasks.json.bak. If something goes wrong, you can restore from this backup.
  3. Corruption quarantine: If easydone encounters an unreadable or malformed file on load, it copies that file to tasks.corrupted-<timestamp>.json instead of discarding it. You can inspect the quarantined file and recover data manually.

If an older file is found (different schema or app version), easydone still loads it but prints a detailed warning so you can review the data before saving again.

Development

Install the development dependency group:

py -m pip install -e ".[dev]"

Run the complete test suite:

py -m pytest

Run a specific test module:

py -m pytest tests/logic_test.py
py -m pytest tests/storage_test.py
py -m pytest tests/format_test.py

License

This project is available under the license in LICENSE.

Metadata

Release files for easydone 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for easydone 0.2.0
File Size Uploaded Provenance Actions
easydone-0.2.0.tar.gz 15.3 kB Without provenance Details for easydone-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for easydone 0.2.0
File Interpreter ABI Platform Actions
easydone-0.2.0-py3-none-any.whl Python 3 none any Details for easydone-0.2.0-py3-none-any.whl

Total release size: 29.6 kB

Release files / easydone-0.2.0.tar.gz

Download URL easydone-0.2.0.tar.gz
Size 15.3 kB
Tags Source
SHA-256 checksum
How to use checksums
e9d643aa663ad901a41dd06eef6516de8fab76b51acde4b77949053b200dc615
BLAKE2b-256 checksum
How to use checksums
695472b4f5242158558f9bac71fce00d538794987fc5f6a61e78d4051682f035
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release files / easydone-0.2.0-py3-none-any.whl

Download URL easydone-0.2.0-py3-none-any.whl
Size 14.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0d974a34bf8713ef23deff1dd33d9e4d218c36ebb1c7f9b35ea9b739ad8171f9
BLAKE2b-256 checksum
How to use checksums
c5fd16aab35632c6bafca29aa218855aa4f77a2c92f0415c94699200a60fa947
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Security for easydone 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page