diff --git a/CHANGELOG.md b/CHANGELOG.md
index dcf333d..1ca8afd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2025-01-XX
+
+### Added
+- Enhanced error handling with detailed error messages showing exit codes and command output
+- `--show-errors` flag for `hostinger:deploy` command to display verbose error information
+- Automatic Git host key verification: Automatically adds Git repository host (GitHub, GitLab, etc.) to `known_hosts` to prevent interactive prompts during first-time cloning
+- Support for all Git hosting providers: Extracts hostname from repository URL automatically (GitHub, GitLab, Bitbucket, etc.)
+
+### Improved
+- Error messages now include exit codes, error output (stderr), and regular output (stdout) from failed SSH commands
+- Deployment failures now provide actionable debugging information instead of generic error messages
+- Fixed first-time repository cloning issue where SSH would prompt for host key verification
+- Better error visibility: Errors with detailed information are automatically shown even without the `--show-errors` flag
+
+### Documentation
+- Added requirement documentation for PHP `exec()` function in README
+- Added SSH public key authentication setup recommendations and instructions
+- Moved environment variables section to the top of README for better visibility
+- Enhanced README with clearer setup instructions and security best practices
+
+### Fixed
+- Fixed deployment failure on first-time git clone due to host key verification prompt
+- Improved error reporting when deployment commands fail with non-zero exit codes
+
 ## [0.2.0] - 2025-10-31
 
 ### Added
diff --git a/README.md b/README.md
index a16ed97..b7854a4 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@ Deploy your Laravel application to Hostinger shared hosting with automated GitHu
 Install the package via Composer:
 
 ```bash
-composer require thecodeholic/laravel-hostinger-deploy:^0.2 --dev
+composer require thecodeholic/laravel-hostinger-deploy:^0.3 --dev
 ```
 
 Or install the latest version:
@@ -77,6 +77,7 @@ php artisan hostinger:deploy
 - `--fresh` - Delete existing files and clone fresh repository
 - `--site-dir=` - Override site directory from config
 - `--token=` - GitHub Personal Access Token (optional, enables automatic deploy key management)
+- `--show-errors` - Display detailed error messages with exit codes and command output
 
 > **Note:** If `GITHUB_API_TOKEN` is provided (via `.env` or `--token` option), the command will automatically add deploy keys to your GitHub repository. Otherwise, you'll be prompted to add the deploy key manually.
 
diff --git a/composer.json b/composer.json
index 317c98f..a1004d8 100644
--- a/composer.json
+++ b/composer.json
@@ -2,7 +2,7 @@
     "name": "thecodeholic/laravel-hostinger-deploy",
     "description": "Laravel package for automated Hostinger deployment with GitHub Actions support",
     "type": "library",
-    "version": "0.2.0",
+    "version": "0.3.0",
     "license": "MIT",
     "keywords": [
         "laravel",