メニュー
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.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/Dicklesworthstone/giil --skill giilコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SOC 職業分類に基づく
SKILL.md を表示中
| name | giil |
| description | 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. |
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 |