Rewrite README to be concise and accurate

- Made it much briefer (76 lines vs 130)
- Added Interactive Shell as key feature with dedicated section
- Removed encrypted cache section (removed for v1)
- Fixed outdated commands (list -> show, etc)
- Added prominent link to full documentation
- Simplified examples to essentials only
- Made features scannable with emoji icons

Author: jszobody

README.md

@@ -4,126 +4,73 @@
 [![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE.md)
 [![Tests](https://img.shields.io/github/actions/workflow/status/stechstudio/keep/tests.yml?branch=main&style=flat-square)](https://github.com/stechstudio/keep/actions/workflows/tests.yml)
 
+**Keep** is your toolkit for secure, collaborative management of application secrets across environments and teams.
 
-**Keep** is your toolkit for collaborative, secure management of secrets across applications, environments, and teams.
+## Key Features
 
-**Key Features:**
-- **CLI Commands** - Manage individual secrets, import/export in bulk, view history and diffs, all via artisan commands
-- **Multi-Vault Support** - Driver-based system, currently supporting AWS SSM Parameter Store and AWS Secrets Manager
-- **Environment Isolation** - Separate secrets by environment (local, staging, production) with access controls
-- **Unified Export System** - Direct export, template processing, and encrypted caching all in one command
-- **Template System** - Replace placeholders in templates with vault secrets while preserving formatting
-- **Team Collaboration** - Share secret management across team members with proper access controls
-- **CI/CD Integration** - Export secrets for deployment pipelines and automated workflows
+- **🔐 Multi-Vault Support** - AWS SSM Parameter Store and AWS Secrets Manager
+- **🚀 Interactive Shell** - Context-aware shell with tab completion for rapid secret management
+- **🌍 Environment Isolation** - Separate secrets by stage (local, staging, production)
+- **📝 Template System** - Merge secrets into templates while preserving structure
+- **🔄 Bulk Operations** - Import, export, copy, and diff secrets across environments
+- **🤝 Team Collaboration** - Share secret management with proper access controls
+- **⚙️ CI/CD Ready** - Export secrets for deployment pipelines
 
-The package provides a secure, organized way to manage application secrets without storing them in version control or sharing them insecurely.
-
-## Quick Start
-
-### Install and configure Keep
-
-Install the package via composer:
+## Quick Example
 
 ```bash
+# Install
 composer require stechstudio/keep
-```
-
-This will install a command in your `vendor/bin` directory called `keep`. Run `keep configure` to configure Keep and your first vault.
 
-```bash
+# Configure
 ./vendor/bin/keep configure
-```
-
-You should now have Keep configured with a default vault. Run `keep verify` to check your setup and ensure you have necessary permissions.
 
-```bash
-./vendor/bin/keep verify
-```
+# Interactive shell - the fastest way to work
+./vendor/bin/keep shell
 
-### Manage secrets
-
-You can add secrets using `keep set`:
-
-```bash
-# You will be prompted for the stage and secret value
-./vendor/bin/keep set DB_PASSWORD
-
-# Or specify the stage and value directly
-./vendor/bin/keep set DB_PASSWORD --stage=production --value="supersecretpassword"
-```
-
-This will store the `DB_PASSWORD` secret in AWS SSM under the path `/[namespace]/production/DB_PASSWORD`.
-
-Check that the secret was added:
-
-```bash
-# Retrieve a single secret
-./vendor/bin/keep get DB_PASSWORD --stage=production
+# Set a secret
+./vendor/bin/keep set DB_PASSWORD "secret" --stage=production
 
-# List all secrets for production
-./vendor/bin/keep list --stage=production
-```
-
-### Using secrets in your application
-
-#### Direct Export - Generate complete `.env` file from secrets
-
-If all your environment variables are managed via Keep, export them directly to a .env file:
-
-```bash
-# Export all secrets from all vaults
+# Export to .env
 ./vendor/bin/keep export --stage=production --file=.env
 
-# Export from specific vaults only
-./vendor/bin/keep export --stage=production --vault=ssm,secrets --file=.env
-
-# Export as JSON format
-./vendor/bin/keep export --stage=production --format=json --file=config.json
+# Use template with placeholders
+./vendor/bin/keep export --stage=production --template=.env.template --file=.env
 ```
 
-#### Template Mode - Merge secrets into a template file
-
-Use a template file with placeholders for sensitive values:
+## Interactive Shell
 
-Example `.env.template`:
+The Keep shell provides a context-aware environment for managing secrets:
 
-```env
-# Application Config
-APP_NAME=MyApp
-APP_ENV=production
-
-# Database - sensitive values from vaults
-DB_HOST={aws-ssm:database/host}
-DB_PORT=3306  # Static value
-DB_PASSWORD={aws-secrets:db-password}
+```bash
+$ ./vendor/bin/keep shell
+Welcome to Keep Shell v1.0.0
 
-# API Keys
-API_KEY={vault1:api/key}
-```
+ssm:local> use production
+Switched to: ssm:production
 
-Then process the template:
+ssm:production> set API_KEY
+Value: ********
 
-```bash
-# Replace placeholders with actual secrets
-./vendor/bin/keep export --stage=production --template=.env.template --file=.env
+ssm:production> copy API_KEY staging
+✓ Copied API_KEY to staging
 
-# Include ALL vault secrets (template + additional)
-./vendor/bin/keep export --stage=production --template=.env.template --all --file=.env
-
-# Handle missing secrets gracefully
-./vendor/bin/keep export --stage=production --template=.env.template --missing=blank --file=.env
+ssm:production> diff staging production
+│ Key     │ staging │ production │ Status │
+├─────────┼─────────┼────────────┼────────┤
+│ API_KEY │ abc...  │ abc...     │ ✓      │
 ```
 
-#### Encrypted Cache - For Laravel Integration
-
-Export secrets to an encrypted cache for use with Laravel's config caching:
+## Documentation
 
-```bash
-./vendor/bin/keep export --stage=production --cache
-```
+📚 **Full documentation available at [https://stechstudio.github.io/keep/](https://stechstudio.github.io/keep/)**
 
-This creates an encrypted cache file in `.keep/cache/` and adds the decryption key to your `.env` file.
+- [Installation & Configuration](https://stechstudio.github.io/keep/guide/installation)
+- [Managing Secrets](https://stechstudio.github.io/keep/guide/managing-secrets/)
+- [Interactive Shell Guide](https://stechstudio.github.io/keep/guide/shell)
+- [AWS Authentication](https://stechstudio.github.io/keep/guide/reference/aws-authentication)
+- [CLI Reference](https://stechstudio.github.io/keep/guide/reference/cli-reference)
 
 ## License
 
-The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
+The MIT License (MIT). Please see [License File](LICENSE.md) for more information.