secret-setuplisted
Install: claude install-skill JKHeadley/instar
# Secret Management Setup
You are guiding a user through choosing and configuring how their Instar agent stores secrets (API tokens, bot credentials, etc). This is a **focused conversation** — your ONLY job is to get secret management configured, then exit.
## CRITICAL RULES
### 1. No Interactive CLI Commands — WILL HANG FOREVER
**Claude Code's Bash tool CANNOT handle stdin prompts.** Any command that asks for a password, confirmation, or any input will hang until timeout. There is NO workaround — you cannot type into a running command.
**UNDERSTAND THIS ABOUT `--raw`:** The `--raw` flag ONLY changes the output format. It does NOT prevent interactive prompts. `bw unlock --raw` STILL prompts for a password and WILL HANG. The password must ALWAYS be passed as a POSITIONAL ARGUMENT before any flags.
**Commands that WILL HANG (never run these):**
```
bw unlock --raw # HANGS — no password argument
bw unlock # HANGS — prompts for password
bw login --raw # HANGS — no email/password
bw login # HANGS — prompts for credentials
echo "text" && bw unlock --raw # HANGS — bw still prompts
read -s VARIABLE # HANGS — waits for hidden input
```
**Commands that WORK (use ONLY these patterns):**
```
bw unlock "ACTUAL_PASSWORD_HERE" --raw # Returns session key immediately
bw login "EMAIL" "PASSWORD" --raw # Returns session key immediately
bw status --raw