docs: fix placeholder URLs and update post-install messages

- Replace placeholder GitHub URLs (github.com/username, github.com/user) with actual repository (github.com/ari1110/pass-cli)
- Update Homebrew/Scoop/GoReleaser post-install messages to mention TUI, doctor, guided init, and keychain features
- Fix deprecated --vault flag examples in MIGRATION.md to use config file approach
- Add vault remove command to README core commands list
- Update keychain status documentation links to point to actual GitHub docs

Files updated:
- cmd/root.go: Fixed placeholder URLs in help text and migration guidance
- cmd/keychain_status.go: Updated docs URL to GitHub
- docs/DOCTOR_COMMAND.md: Fixed placeholder URL in example output
- docs/MIGRATION.md: Replaced --vault flag with config file approach in Option C
- homebrew/pass-cli.rb: Enhanced caveats with modern features
- scoop/pass-cli.json: Enhanced post_install and notes sections
- .goreleaser.yml: Updated brew/scoop messages, removed --vault flag
- README.md: Added vault remove to core commands
- specs/002-fix-untested-features/quickstart.md: Fixed import path placeholders

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: arimxyer

.goreleaser.yml

@@ -288,8 +288,22 @@ brews:
 
     # Caveats shown after installation
     caveats: |
-      To get started with Pass-CLI:
-        pass-cli --vault ~/.pass-cli.enc init
+      Pass-CLI: Secure password manager with TUI and CLI interfaces
+
+      First-time users: Run `pass-cli` (no arguments) for guided setup.
+
+      Quick start:
+        pass-cli          - Launch interactive TUI
+        pass-cli init     - Initialize vault manually
+        pass-cli doctor   - Run health checks
+
+      Features:
+        • Interactive TUI for visual management
+        • Keychain integration: pass-cli keychain enable
+        • Usage tracking and audit logging
+
+      Vault location: ~/.pass-cli/vault.enc
+      Complete guide: https://github.com/ari1110/pass-cli/blob/main/docs/GETTING_STARTED.md
 
 # Scoop bucket (automated manifest creation and updates)
 scoops:
@@ -311,5 +325,6 @@ scoops:
 
     # Post-install message (array of PowerShell commands)
     post_install:
-      - "Write-Host 'To get started with Pass-CLI:' -ForegroundColor Green"
-      - "Write-Host '  pass-cli --vault $env:USERPROFILE\\.pass-cli.enc init' -ForegroundColor Cyan"
+      - "Write-Host 'Pass-CLI installed! First-time: Run `pass-cli` for guided setup.' -ForegroundColor Green"
+      - "Write-Host 'TUI: pass-cli | Health check: pass-cli doctor | Enable keychain: pass-cli keychain enable' -ForegroundColor Cyan"
+      - "Write-Host 'Guide: https://github.com/ari1110/pass-cli/blob/main/docs/GETTING_STARTED.md' -ForegroundColor Yellow"

README.md

@@ -122,6 +122,9 @@ pass-cli delete github
 # Generate password
 pass-cli generate --length 32
 
+# Remove vault
+pass-cli vault remove
+
 # Health check
 pass-cli doctor
 ```

cmd/keychain_status.go

@@ -116,12 +116,12 @@ func runKeychainStatus(cmd *cobra.Command, args []string) error {
 		} else if meta != nil && !meta.KeychainEnabled {
 			fmt.Printf("✓ Vault Configuration:    Keychain not enabled\n\n")
 			fmt.Println("System keychain is not accessible. You will be prompted for password on each command.")
-			fmt.Println("See documentation for keychain setup: https://docs.pass-cli.com/keychain")
+			fmt.Println("See documentation for keychain setup: https://github.com/ari1110/pass-cli/blob/main/docs/GETTING_STARTED.md#keychain-integration")
 		} else {
 			// No metadata - legacy vault
 			fmt.Println()
 			fmt.Println("System keychain is not accessible. You will be prompted for password on each command.")
-			fmt.Println("See documentation for keychain setup: https://docs.pass-cli.com/keychain")
+			fmt.Println("See documentation for keychain setup: https://github.com/ari1110/pass-cli/blob/main/docs/GETTING_STARTED.md#keychain-integration")
 		}
 	}
 

cmd/root.go

@@ -50,7 +50,7 @@ Examples:
   # List all credentials
   pass-cli list
 
-For more information, visit: https://github.com/username/pass-cli`,
+For more information, visit: https://github.com/ari1110/pass-cli`,
 		PersistentPreRunE: checkFirstRun,
 		Run:               runRootCommand,
 	}
@@ -79,7 +79,7 @@ Instead, configure your vault location in the config file:
   3. Run your command without the --vault flag
 
 For more details, see the migration guide:
-  https://github.com/username/pass-cli/docs/MIGRATION.md
+  https://github.com/ari1110/pass-cli/blob/main/docs/MIGRATION.md
 
 Original error: %w`, os.Getenv("HOME"), err)
 		}

docs/DOCTOR_COMMAND.md

@@ -139,7 +139,7 @@ esac
 **Symptom**:
 ```
 ⚠ Version: Update available: v1.2.3 → v1.2.4
-  Recommendation: Update to latest version: https://github.com/user/pass-cli/releases/tag/v1.2.4
+  Recommendation: Update to latest version: https://github.com/ari1110/pass-cli/releases/tag/v1.2.4
 ```
 
 **Solution**: Update pass-cli to the latest version using your package manager or download from GitHub.

docs/MIGRATION.md

@@ -233,23 +233,35 @@ pass-cli migrate --iterations 600000 --enable-audit
 
 1. **Create new vault in custom location**:
    ```bash
-   pass-cli --vault ~/.pass-cli/vault-new.enc init --enable-audit
+   # Create config for new vault
+   mkdir -p ~/.pass-cli
+   echo "vault_path: ~/.pass-cli/vault-new.enc" > ~/.pass-cli/config-new.yml
+
+   # Initialize new vault
+   pass-cli --config ~/.pass-cli/config-new.yml init --enable-audit
    ```
 
 2. **Add new credentials to new vault**:
    ```bash
-   pass-cli --vault ~/.pass-cli/vault-new.enc add newservice
+   pass-cli --config ~/.pass-cli/config-new.yml add newservice
    ```
 
 3. **Keep old vault for existing credentials**:
    ```bash
-   pass-cli --vault ~/.pass-cli/vault-old.enc get oldservice
+   # Use default config (points to ~/.pass-cli/vault.enc)
+   pass-cli get oldservice
    ```
 
 4. **Switch to new vault when ready**:
    ```bash
-   mv ~/.pass-cli/vault-old.enc ~/.pass-cli/vault-old-backup.enc
+   # Backup old vault
+   mv ~/.pass-cli/vault.enc ~/.pass-cli/vault-old-backup.enc
+
+   # Promote new vault to default
    mv ~/.pass-cli/vault-new.enc ~/.pass-cli/vault.enc
+
+   # Update default config (or remove custom config file)
+   rm ~/.pass-cli/config-new.yml
    ```
 
 ## Backward Compatibility

homebrew/pass-cli.rb

@@ -39,16 +39,22 @@ def install
 
   def caveats
     <<~EOS
-      Pass-CLI is a secure password manager that stores credentials locally.
+      Pass-CLI: Secure password manager with TUI and CLI interfaces
 
-      To get started:
-        1. Initialize your vault: pass-cli init
-        2. Add a credential: pass-cli add myservice
-        3. Retrieve it: pass-cli get myservice
+      First-time users: Run `pass-cli` (no arguments) for guided setup.
 
-      Your vault is stored at: ~/.pass-cli/
+      Quick start:
+        pass-cli          - Launch interactive TUI
+        pass-cli init     - Initialize vault manually
+        pass-cli doctor   - Run health checks
 
-      For more information, run: pass-cli --help
+      Features:
+        • Interactive TUI for visual management
+        • Keychain integration: pass-cli keychain enable
+        • Usage tracking and audit logging
+
+      Vault location: ~/.pass-cli/vault.enc
+      Complete guide: https://github.com/ari1110/pass-cli/blob/main/docs/GETTING_STARTED.md
     EOS
   end
 

scoop/pass-cli.json

@@ -34,24 +34,34 @@
   "post_install": [
     "Write-Host 'Pass-CLI has been installed successfully!' -ForegroundColor Green",
     "Write-Host ''",
-    "Write-Host 'To get started:' -ForegroundColor Yellow",
-    "Write-Host '  1. Initialize your vault: pass-cli init'",
-    "Write-Host '  2. Add a credential: pass-cli add myservice'",
-    "Write-Host '  3. Retrieve it: pass-cli get myservice'",
+    "Write-Host 'First-time users: Run `pass-cli` (no arguments) for guided setup.' -ForegroundColor Yellow",
     "Write-Host ''",
-    "Write-Host 'Your vault will be stored at: ~\\.pass-cli\\' -ForegroundColor Cyan",
-    "Write-Host 'For more information, run: pass-cli --help'"
+    "Write-Host 'Quick start:' -ForegroundColor Yellow",
+    "Write-Host '  pass-cli          - Launch interactive TUI'",
+    "Write-Host '  pass-cli init     - Initialize vault manually'",
+    "Write-Host '  pass-cli doctor   - Run health checks'",
+    "Write-Host ''",
+    "Write-Host 'Your vault will be stored at: ~\\.pass-cli\\vault.enc' -ForegroundColor Cyan",
+    "Write-Host 'Complete guide: https://github.com/ari1110/pass-cli/blob/main/docs/GETTING_STARTED.md'"
   ],
   "notes": [
-    "Pass-CLI stores credentials securely using Windows Credential Manager.",
-    "Your vault is encrypted with AES-256-GCM encryption.",
+    "Pass-CLI: Secure password manager with TUI and CLI interfaces",
+    "",
+    "Key Features:",
+    "  • Interactive TUI for visual credential management",
+    "  • Windows Credential Manager integration (enable: pass-cli keychain enable)",
+    "  • Health diagnostics (run: pass-cli doctor)",
+    "  • Usage tracking across projects",
+    "  • AES-256-GCM encryption with audit logging",
     "",
-    "Quick start:",
-    "  pass-cli init       - Initialize a new vault",
-    "  pass-cli add <name> - Add a new credential",
-    "  pass-cli get <name> - Retrieve a credential",
-    "  pass-cli list       - List all credentials",
+    "Quick commands:",
+    "  pass-cli                 - Launch TUI (first-time: guided setup)",
+    "  pass-cli add <name>      - Add credential",
+    "  pass-cli get <name>      - Retrieve credential",
+    "  pass-cli list            - List all credentials",
+    "  pass-cli keychain enable - Enable auto-unlock",
+    "  pass-cli doctor          - Verify vault health",
     "",
-    "Run 'pass-cli --help' for full documentation."
+    "Documentation: https://github.com/ari1110/pass-cli/blob/main/docs/GETTING_STARTED.md"
   ]
 }

specs/002-fix-untested-features/quickstart.md

@@ -160,7 +160,7 @@ import (
     "testing"
     "time"
 
-    "github.com/yourusername/pass-cli/internal/vault"
+    "github.com/ari1110/pass-cli/internal/vault"
     "github.com/stretchr/testify/assert"
     "github.com/stretchr/testify/require"
 )
@@ -229,7 +229,7 @@ package cmd
 import (
     "fmt"
     "github.com/spf13/cobra"
-    "github.com/yourusername/pass-cli/internal/vault"
+    "github.com/ari1110/pass-cli/internal/vault"
 )
 
 func init() {