Update README and add help command to CLI; bump version to 1.0.3

Author: decodingchris

README.md

@@ -2,8 +2,6 @@
 
 Private version control for your Git ignored files.
 
----
-
 ## Why use GitGhost?
 
 - **Keep sensitive files private:** Manage secrets, configs, or personal files outside your public repo.
@@ -12,16 +10,12 @@ Private version control for your Git ignored files.
 - **Separate private repo:** Keeps your private data secure and versioned.
 - **Cross-platform:** Designed for Linux, works on any system with Python 3.10+.
 
----
-
 ## Requirements
 
 - Python 3.10 or higher
 - Git installed
 - GitHub CLI (`gh`) is required for private repo automation
 
----
-
 ## Installation
 
 Install GitGhost directly from PyPI:
@@ -30,9 +24,7 @@ Install GitGhost directly from PyPI:
 pip install gitghost
 ```
 
----
-
-## Quick Start
+## Commands
 
 Initialize GitGhost in your project:
 
@@ -58,7 +50,11 @@ Discard private changes:
 gitghost discard
 ```
 
----
+Get help and list all commands:
+
+```bash
+gitghost help
+```
 
 ## How it works
 
@@ -68,16 +64,12 @@ gitghost discard
 - `gitghost status` shows private file changes.
 - Keeps private data out of your public repo, but safely versioned.
 
----
-
 ## Links
 
 - **PyPI:** [https://pypi.org/project/gitghost/](https://pypi.org/project/gitghost/)
 - **Source Code:** [https://github.com/decodingchris/gitghost](https://github.com/decodingchris/gitghost)
 - **Issue Tracker:** [https://github.com/decodingchris/gitghost/issues](https://github.com/decodingchris/gitghost/issues)
 
----
-
 ## License
 
 This project is licensed under the **MIT License**. See the [LICENSE](https://opensource.org/licenses/MIT) file for details.

gitghost/cli.py

@@ -301,6 +301,12 @@ def block_present(content):
         with open(gitignore_path, "w") as f:
             f.write(vault_block)
         click.echo("Created .gitignore with GitGhost block")
+@cli.command()
+@click.pass_context
+def help(ctx):
+    """Show this message and exit."""
+    click.echo(cli.get_help(ctx))
+
 
 if __name__ == "__main__":
     cli()

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitghost"
-version = "1.0.2"
+version = "1.0.3"
 description = "Private version control for your Git ignored files."
 authors = [
     { name = "Decoding Chris" }

tests/test_integration.py

@@ -281,4 +281,10 @@ def test_cli_entry_point():
     # Cover line 300
     from gitghost import cli as cli_module
     with pytest.raises(SystemExit):
-        cli_module.cli()
+        cli_module.cli()
+
+def test_help_command(runner):
+    result = runner.invoke(cli, ['help'])
+    assert result.exit_code == 0
+    assert 'Usage:' in result.output
+    assert 'Commands:' in result.output