Download full-resolution images from iCloud, Dropbox, Google Photos share links. Use when extracting images from cloud share URLs, remote debugging with screenshots, or downloading shared photo albums.
The English summary is being prepared. Showing the original description.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
Core Capability: Zero-setup CLI that downloads full-resolution images from cloud photo shares. The missing link between iPhone screenshots and remote AI coding sessions.
# Install
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/giil/main/install.sh?v=3.0.0" | bash
# Download single image
giil "https://share.icloud.com/photos/02cD9okNHvVd-uuDnPCH3ZEEA"
# JSON output (best for AI workflows)
giil "https://share.icloud.com/photos/..." --json
# Download entire album
giil "https://share.icloud.com/photos/..." --all --output ~/album
Note: First run downloads Playwright Chromium (~200MB, cached in ~/.cache/giil/).
iPhone Screenshot → iCloud Sync → Photos.app Share Link → Paste to SSH → giil Downloads → AI Analyzes
# Get image for AI analysis
IMAGE_PATH=$(giil "https://share.icloud.com/photos/XXX" --output /tmp 2>/dev/null)
# AI can now read the image at $IMAGE_PATH
# Default: file path to stdout
giil "https://share.icloud.com/photos/XXX"
# stdout: /current/dir/icloud_20240115_143245.jpg
# JSON mode (best for programmatic use)
giil "..." --json
# {"ok": true, "path": "/absolute/path/...", "width": 4032, "height": 3024}
# Base64 mode (no file saved)
giil "..." --base64 | base64 -d > image.jpg
# URL-only mode (get CDN URL without downloading)
giil "..." --print-url
| Platform | URL Patterns | Browser Required |
|---|---|---|
| iCloud | share.icloud.com/photos/* | Yes |
| Dropbox | dropbox.com/s/*, dropbox.com/scl/fi/* | No (fast) |
| Google Photos | photos.app.goo.gl/*, photos.google.com/share/* | Yes |
| Google Drive | drive.google.com/file/d/* | Yes |
Dropbox Fast Path: Direct curl download, 1-2 seconds, no browser overhead.
| Flag | Description |
|---|---|
--output DIR | Output directory (default: .) |
--json | Output JSON metadata |
--all | Download all photos from album |
--preserve | Keep original bytes (skip compression) |
--convert FMT | Convert to: jpeg, png, webp |
--quality N | JPEG quality 1-100 (default: 85) |
--base64 | Output base64 to stdout |
--timeout N | Page load timeout in seconds (default: 60) |
--debug | Save debug artifacts on failure |
| Code | Meaning |
|---|---|
0 | Success |
10 | Network error |
11 | Auth required (link not public) |
12 | Not found (expired/deleted) |
13 | Unsupported type (video, doc) |
| Topic | Reference |
|---|---|
| Full command reference | COMMANDS.md |
| Four-tier capture strategy | CAPTURE-STRATEGY.md |
| Troubleshooting | TROUBLESHOOTING.md |
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
The philosophy and practical benefits of agent fungibility in multi-agent software development. Why homogeneous, interchangeable agents outperform specialized role-based systems at scale.
The English summary is being prepared. Showing the original description.
MCP Agent Mail for multi-agent coordination. Use when agents need file locks, messaging, inboxes, or conflict prevention. Handles macro_start_session, file_reservation_paths, send_message, threading, pre-commit guards.
The English summary is being prepared. Showing the original description.
Jeffrey Emanuel's multi-agent implementation workflow using NTM, Agent Mail, Beads, and BV. The execution phase that follows planning and bead creation. Includes exact prompts used.
The English summary is being prepared. Showing the original description.
Convert markdown plans into beads with dependencies using br CLI. Use when creating task graphs, polishing beads before implementation, or bridging planning to agent swarm execution.
The English summary is being prepared. Showing the original description.
Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.
The English summary is being prepared. Showing the original description.
Manage AI coding CLI accounts with sub-100ms switching. Use when hitting rate limits on Claude Max, GPT Pro, or Gemini Ultra subscriptions and need instant account swapping without browser OAuth.
The English summary is being prepared. Showing the original description.