my-vault/.claude/commands/download-attachment.md

download-attachment

Download files from URLs to attachments folder and organize them with descriptive names.

Usage

/download-attachment <url1> [url2] [url3...]

Examples

/download-attachment https://example.com/document.pdf
/download-attachment https://site.com/image.png https://site.com/report.pdf

Implementation

You are tasked with downloading files from URLs and organizing them in the Obsidian vault attachments folder.

Step 1: Parse and Validate URLs

Extract the URL(s) from the user's input. Handle multiple URLs if provided.

• Validate URL scheme: Only allow http:// or https:// URLs
• Reject invalid URLs: file://, ftp://, or malformed URLs
• Example validation:

if [[ ! "$url" =~ ^https?:// ]]; then
  echo "Error: Only HTTP/HTTPS URLs are allowed"
  exit 1
fi

Step 2: Download Files

For each URL:

# Sanitize filename to prevent path traversal
# Remove ../ and other dangerous characters
filename=$(basename "$url" | sed 's/[^a-zA-Z0-9._-]/_/g')

# Use wget or curl to download with timeout
wget --timeout=30 -O "05_Attachments/$filename" "$url"
# or
curl --max-time 30 -L "$url" -o "05_Attachments/$filename"

Step 3: Verify Downloads

Check that files were downloaded successfully:

ls -la "05_Attachments/"

Step 4: Organize Files

After downloading, run the organize-attachments command to rename files with descriptive names:

For PDFs:

• Extract text with pdftotext
• Analyze content for meaningful title

For Images:

• Use mcp__gemini-vision__analyze_image or mcp__gemini-vision__analyze_multiple
• Generate descriptive filename based on content

Step 5: Move to Organized

Move renamed files to 05_Attachments/Organized/ with descriptive names

Step 6: Update Index

Add entries to 05_Attachments/00_Index.md

Step 7: Commit Changes

git add -A
git commit -m "Download and organize attachments from URLs"
git push

Important Notes

1. File Naming:

   • Initial download: Use URL filename or generate from URL
   • After analysis: Rename with descriptive title

2. Supported Types:

   • Images: .png, .jpg, .jpeg, .gif, .webp
   • Documents: .pdf, .doc, .docx
   • Text: .txt, .md
   • Data: .csv, .xlsx

3. Error Handling:

   • Check if URL is accessible
   • Verify file downloaded correctly
   • Handle download failures gracefully

4. Organization:

   • Downloaded files go to 05_Attachments/
   • After renaming, move to 05_Attachments/Organized/
   • Update links across vault if needed

Workflow

1. Download file(s) from provided URL(s)
2. Identify file type and analyze content
3. Generate descriptive filename
4. Move to Organized folder
5. Update index and references
6. Commit and push changes

Tips

• For multiple URLs, process them in batch for efficiency
• Use Gemini Vision for batch image analysis (up to 3 at once)
• Extract meaningful context from PDFs before renaming
• Preserve original file extensions
• Keep filenames concise but descriptive (max 60 chars)