diff --git a/.env.example b/.env.example
index 527eaaa..4adf7b3 100644
--- a/.env.example
+++ b/.env.example
@@ -1,43 +1,21 @@
 # Kuma Strapper Environment Variables
+#
+# 1Password Connect (optional):
+#   Set OP_CONNECT_HOST and OP_CONNECT_TOKEN to enable op:// references
+#   for secrets (SSH_PRIVATE_KEY, UPTIME_KUMA_API_KEY, CLAUDE_API_KEY)
+#   Example: SSH_PRIVATE_KEY=op://Vault/SSH Key/private key
+#
+# SSH_PRIVATE_KEY: Base64-encoded key (base64 -w 0 ~/.ssh/id_rsa)
+# UPTIME_KUMA_API_KEY: From Uptime Kuma Settings > API Keys
+# CLAUDE_API_KEY: From https://console.anthropic.com/
 
-# =============================================================================
-# 1Password Connect (Optional - for secure secret management)
-# =============================================================================
-# When configured, secrets below can use op:// references instead of raw values
-# Example: SSH_PRIVATE_KEY=op://Vault/SSH Key/private key
+OP_CONNECT_HOST=
+OP_CONNECT_TOKEN=
 
-# 1Password Connect server URL
-#OP_CONNECT_HOST=http://op-connect-api:8080
-
-# 1Password Connect access token
-#OP_CONNECT_TOKEN=
-
-# =============================================================================
-# Required Settings
-# =============================================================================
-
-# Base64-encoded SSH private key (or op:// reference)
-# To encode your key: base64 -w 0 ~/.ssh/id_rsa
 SSH_PRIVATE_KEY=
-
-# Uptime Kuma instance URL
 UPTIME_KUMA_URL=http://localhost:3001
-
-# Uptime Kuma API token (or op:// reference)
-# Get this from Uptime Kuma Settings > API Keys
 UPTIME_KUMA_API_KEY=
-
-# Claude/Anthropic API key (or op:// reference)
-# Get this from https://console.anthropic.com/
 CLAUDE_API_KEY=
 
-# =============================================================================
-# Optional Settings
-# =============================================================================
-
-# Enable dev mode on startup
-# When enabled, Claude-suggested SSH commands require approval
 DEV_MODE=false
-
-# Enable debug mode for development
 DEBUG=false