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, anddone - Four priority levels:
low,normal,high, andurgent - Filter tasks by status, priority, or both
- Human-readable JSON storage with no database setup
- Bulletproof data handling: atomic writes, automatic
.bakbackups, 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, orin-progress; defaults tonot-done-p,--priority:low,normal,high, orurgent; defaults tolow
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:
- Atomic writes: Every save writes to a temporary file first, then swaps it atomically. A crash mid‑write never leaves a half‑written file.
- Automatic backups: Before every save, the current
tasks.jsonis copied totasks.json.bak. If something goes wrong, you can restore from this backup. - Corruption quarantine: If easydone encounters an unreadable or malformed file on load, it copies that file to
tasks.corrupted-<timestamp>.jsoninstead 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.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| easydone-0.2.1.tar.gz | 15.3 kB | Without provenance | Details for easydone-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| easydone-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for easydone-0.2.1-py3-none-any.whl |
Total release size: 29.6 kB
Release files / easydone-0.2.1.tar.gz
| Download URL | easydone-0.2.1.tar.gz |
|---|---|
| Size | 15.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7df8147c3b0d6e356de8dba894dfaddf3d3f08c7801033af48256520a2bf2df7
|
|
BLAKE2b-256 checksum How to use checksums |
b385c7fb4d8e5463cfc031bd1344547ca7fd88ee5880e060924de4db50a5f17b
|
| 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.1-py3-none-any.whl
| Download URL | easydone-0.2.1-py3-none-any.whl |
|---|---|
| Size | 14.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
356d40d22c296f93ead2bddbc8288660fa1f5ba329ec998e71ec6338a7c09af2
|
|
BLAKE2b-256 checksum How to use checksums |
bbd36d81b1aad3f94b3d3ad020fd4bca455c05103e41b4541c34fe3e021db3cf
|
| 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.1
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.