Enhance README and CLI: add help command, improve instructions, and update version to 1.0.7

Author: decodingchris

README.md

@@ -5,25 +5,17 @@ A terminal to-do app that helps you focus on one task at a time.
 [![PyPI version](https://img.shields.io/pypi/v/tasknow.svg)](https://pypi.org/project/tasknow/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
----
-
 ## Why use TaskNow?
 
-- **Stay focused:** See just your current task by default
-- **Minimalist & distraction-free:** No accounts, no clutter — just your tasks
-- **Full control:** Add, complete, edit, and manage tasks easily from the terminal
-- **Simple commands:** Intuitive CLI interface
-- **Lightweight:** Python-based with JSON storage, works seamlessly on Linux
-
----
+- Stay focused by seeing just your current task
+- Add, complete, and manage tasks easily from the terminal
+- No accounts, no clutter — just your tasks
 
 ## Requirements
 
 - **Python 3.10 or higher**
 - Compatible with Ubuntu/Linux systems
 
----
-
 ## Installation
 
 Install TaskNow directly from PyPI:
@@ -32,9 +24,7 @@ Install TaskNow directly from PyPI:
 pip install tasknow
 ```
 
----
-
-## Quick Start
+## Commands
 
 Add a task:
 
@@ -57,13 +47,13 @@ tasknow done
 List all tasks:
 
 ```bash
-tasknow list
+tasknow list # Also shows each task id
 ```
 
 Remove a task:
 
 ```bash
-tasknow remove 3
+tasknow remove 2 # Remove task with id: 2
 ```
 
 Show completed tasks:
@@ -75,37 +65,27 @@ tasknow completed
 Un-complete a task:
 
 ```bash
-tasknow undone 3
+tasknow undone 3 # Un-complete task with id: 3
 ```
 
 Edit a task:
 
 ```bash
-tasknow edit 2 "New task description"
+tasknow edit 4 "New task description" # Edit task with id: 4
 ```
 
----
-
-For more commands and details, see the full documentation or run:
+Show help:
 
 ```bash
-tasknow --help
+tasknow help
 ```
 
----
-
 ## Links
 
 - **PyPI:** [https://pypi.org/project/tasknow/](https://pypi.org/project/tasknow/)
 - **Source Code:** [https://github.com/decodingchris/tasknow](https://github.com/decodingchris/tasknow)
 - **Issue Tracker:** [https://github.com/decodingchris/tasknow/issues](https://github.com/decodingchris/tasknow/issues)
 
----
-
 ## License
 
 This project is licensed under the **MIT License**. See the [LICENSE](https://opensource.org/licenses/MIT) file for details.
-
----
-
-MIT License © Decoding Chris

main.py

@@ -156,6 +156,9 @@ def main() -> None:
         epilog='If no command is provided, defaults to showing the current task.'
     )
     subparsers = parser.add_subparsers(dest='command')
+    
+    # Help command
+    subparsers.add_parser('help', help='Show help message')
 
     # Show current task
     subparsers.add_parser('show', help='Show current task')
@@ -233,6 +236,8 @@ def main() -> None:
             manager.remove_task(args.id)
             print(f"Removed task {args.id}")
 
+        elif args.command == 'help':
+            parser.print_help()
         elif args.command == 'undone':
             manager.reopen_task(args.id)
             print(f"Marked task {args.id} as undone")

setup.py

@@ -2,7 +2,7 @@
 
 setup(
     name="tasknow",
-    version="1.0.6",
+    version="1.0.7",
     description="A terminal to-do app that helps you focus on one task at a time.",
     long_description="""# TaskNow
 
@@ -14,9 +14,14 @@
 - Add, complete, and manage tasks easily from the terminal
 - No accounts, no clutter — just your tasks
 
+## Requirements
+
+- **Python 3.10 or higher**
+- Compatible with Ubuntu/Linux systems
+
 ## Installation
 
-You can install TaskNow directly from PyPI:
+Install TaskNow directly from PyPI:
 
 ```bash
 pip install tasknow
@@ -36,17 +41,17 @@
 
 Mark it done:
 ```bash
-tasknow done
+tasknow done 
 ```
 
 List all tasks:
 ```bash
-tasknow list
+tasknow list # Also shows each task id
 ```
 
 Remove a task:
 ```bash
-tasknow remove <id>
+tasknow remove 2 # Remove task with id: 2
 ```
 
 Show completed tasks:
@@ -56,17 +61,19 @@
 
 Un-complete a task:
 ```bash
-tasknow undone <id>
+tasknow undone 3 # Un-complete task with id: 3
 ```
 
 Edit a task:
 ```bash
-tasknow edit <id> "New description"
+tasknow edit 4 "New description" # Edit task with id: 4
 ```
 
----
+Show help:
 
-MIT License
+```bash
+tasknow help
+```
 """,
     long_description_content_type="text/markdown",
     author="Decoding Chris",

test_main.py

@@ -369,4 +369,18 @@ def test_cli_default_to_show(capsys, tmp_path):
             cli_main()
 
         captured = capsys.readouterr()
-        assert "Current task: Default show task" in captured.out
+        assert "Current task: Default show task" in captured.out
+
+
+def test_cli_help_command(capsys):
+    """Test the help command prints help message."""
+    from main import main as cli_main
+
+    # Simulate running 'tasknow help'
+    with patch('sys.argv', ['main.py', 'help']):
+        cli_main()
+
+    captured = capsys.readouterr()
+    assert "usage: main.py" in captured.out
+    assert "Show current task" in captured.out
+    assert "help" in captured.out