Raycast/README.md

Raycast Scripts

Personal Raycast script collection.

Structure

scripts/   # Raycast script commands
envs/      # Per-script .env files (gitignored)
utils.zsh   # Shared helper: load_env

Scripts

Script	Icon	Description
base64.zsh	🔡	Encode/decode base64 — text, file path, or clipboard
get_graph_user.zsh	👤	Fetch MS Graph user info by ID or UPN
imgflip-meme.zsh	🖼️	Generate a meme via imgflip webhook, copy to clipboard
ipv4-get.zsh	🌐	Copy public IPv4 to clipboard
no-as-a-service.zsh	❌	Random rejection reason from No-as-a-Service
x.zsh	🤖	Copy Bruno ✕ character to clipboard

Environment files

Scripts that need secrets use load_env from utils.zsh. Each script auto-loads envs/<script-name>.env at runtime.

Example — envs/get_graph_user.env:

AZURE_TENANT_ID="..."
AZURE_CLIENT_ID="..."
AZURE_CLIENT_SECRET="..."

Example — envs/imgflip-meme.env:

N8N_WEBHOOK_BASE_URL="..."
N8N_WEBHOOK_IMGFLIP_API_KEY="..."

Keep envs/ out of version control.

Adding a new script

1. Create scripts/my-script.zsh with Raycast metadata headers.
2. Source the helper and call load_env:

   source "$HOME/Raycast/utils.zsh"
   load_env VAR1 VAR2 || exit 1
   

3. Create the matching envs/my-script.env with the required variables.