Universal download accelerator for AI coding agents — aria2-powered multi-connection downloads, Git shallow clones, checksum verification, and smart fallbacks. Works with OpenCode, Claude Code, Codex, Continue, Cline, VS Code, Cursor, Windsurf, JetBrains AI, Amazon Q, Warp, and any shell.
Your internet is fast. Your AI agent's downloads are slow.
| Tool | Default Behavior | Result |
|---|---|---|
curl |
Single connection | ~5 MB/s on 100+ MB/s line |
git clone |
Full history | 10x bandwidth waste |
npm/pip |
No retry tuning | Flaky on large packages |
| Interrupted download | Manual restart | Waste time & bandwidth |
One skill, every agent, maximum speed.
┌────────────────────────────────────────────────────────────┐
│ fast-download │
├────────────────────────────────────────────────────────────┤
│ ▸ aria2: 16 parallel connections, auto-resume, checksums │
│ ▸ Git: --depth=1 --filter=blob:none (90% less data) │
│ ▸ Fallback: curl with resume when servers rate-limit │
│ ▸ Verification: Built-in SHA256/MD5 validation │
│ ▸ Config: Optimized git/npm/pip defaults │
└────────────────────────────────────────────────────────────┘
| Scenario | Before | After | Improvement |
|---|---|---|---|
| Large file (CDN) | 5 MB/s | 39 MB/s | 7.8× |
| GitHub release (2.4 MB) | 2.6 MB/s | 2.5 MB/s | Server-limited |
| Git clone (full) | 43.6s | 43.6s | When needed |
| Git clone (shallow) | N/A | 10.6s | New: 4.1× faster |
| Resume interrupted | Manual | Automatic | ✨ UX |
irm https://raw.githubusercontent.com/AbdullahAlHadi2589/Fast-Download/master/scripts/install.ps1 | iexcurl -fsSL https://raw.githubusercontent.com/AbdullahAlHadi2589/Fast-Download/master/scripts/install.sh | bashEasiest way: Copy the Github link and paste it into your AI coding agent (OpenCode, Claude Code, Cursor, etc.) — it will handle the installation automatically.
- Install aria2:
winget install aria2.aria2/brew install aria2/apt install aria2 - Clone the repo or copy the relevant agent folder (see table above)
- Place files in your agent's config location
- Restart your agent
| Agent | Config Location in Repo | Install Method | Status |
|---|---|---|---|
| OpenCode | opencode/SKILL.md |
Auto-discovered from ~/.config/opencode/skill/fast-download/ |
✅ |
| Claude Code | claude-code/fast-download.md |
Place in ~/.claude/agents/ folder |
✅ |
| Cursor | cursor/fast-download/.cursorrules |
Add .cursorrules to project root |
✅ |
| Cline | cline/fast-download/.clinerules |
Add .clinerules to project root |
✅ |
| Windsurf | windsurf/fast-download/.windsurfrules |
Add .windsurfrules to project root |
✅ |
| VS Code (Extension) | vscode/fast-download/package.json |
Run code --install-extension fast-download (when published) |
✅ |
| JetBrains AI | jetbrains/fast-download.md |
Place in JetBrains AI agents folder | Prompt-only |
| OpenAI Codex | codex/fast-download.md |
Place in ~/.codex/agents/ folder |
✅ |
| Continue.dev | continue/fast-download.yaml |
Add to .continue/agents/ config |
✅ |
| Amazon Q Developer | amazon-q/fast-download.md |
Place in ~/.aws/amazonq/agents/ folder |
✅ |
| Warp | warp/fast-download.yaml |
Add to ~/.warp/agents/ folder |
✅ |
| Any Shell | src/fast-download.sh |
Source ~/.fast-download/fast-download.sh |
✅ |
After install, just use these patterns in any terminal:
# Preferred: aria2 with 16 connections, resume, verification
aria2c -x 16 -s 16 -k 1M --continue=true -o "file.zip" "https://example.com/file.zip"
# With SHA256 verification
aria2c --checksum=sha256=abc123... -x 16 -s 16 -o "file.zip" "https://example.com/file.zip"
# Rate-limited servers (GitHub, proof.ovh.net) - use 4 connections
aria2c -x 4 -s 4 -k 1M --continue=true -o "file.zip" "https://github.com/.../file.zip"
# Fallback: curl with resume
curl -L -C - -o "file.zip" "https://example.com/file.zip"# Shallow clone (preferred - 90% less data, 4× faster)
git clone --depth 1 --single-branch --filter=blob:none https://github.com/user/repo.git
# Full clone (when history required)
git clone https://github.com/user/repo.git
# Specific branch, shallow
git clone --depth 1 --branch master https://github.com/user/repo.gitImport-Module "~/.fast-download/FastDownload.psm1"
# Smart download (auto-selects aria2/curl)
Invoke-FastDownload -Url "https://example.com/large.zip" -OutputPath "C:\Downloads\large.zip"
# Git clone with options
Invoke-GitClone -Url "https://github.com/user/repo.git" -OutputPath "C:\Projects\repo" -Shallow
# Verify checksum
Test-FileChecksum -FilePath "file.zip" -ExpectedHash "abc123..." -Algorithm SHA256# Source once
source ~/.fast-download/fast-download.sh
# Then use:
fd_download "https://example.com/file.zip" "~/Downloads/file.zip" "sha256:abc123..."
fd_git_clone "https://github.com/user/repo.git" "~/Projects/repo" true
fd_verify "file.zip" "abc123..."
fd_speed_test
fd_init # Apply git/npm/pip optimizations┌────────────────────────────────────────────────────────────┐
│ DOWNLOAD REQUEST │
└────────────────────────────────────────────────────────────┘
│
▼
┌────────────────────────────────────────────────────────────┐
│ Is it a Git URL? │
│ ├── YES → git clone --depth 1 --filter=blob:none │
│ └── NO → Continue │
└────────────────────────────────────────────────────────────┘
│
▼
┌────────────────────────────────────────────────────────────┐
│ File > 10MB AND server supports Range requests? │
│ ├── YES → aria2c -x 16 -s 16 (16 parallel connections) │
│ ├── NO (rate-limited) → aria2c -x 4 -s 4 OR curl -C - │
│ └── NO (small/unknown) → curl (lower overhead) │
└────────────────────────────────────────────────────────────┘
- SHA256/MD5 checksums validated automatically after every download
- Corrupted files deleted on mismatch — no partial files left behind
- Resume support via
curl -C -and aria2's built-in continuation
# Git: compression, larger buffers, no low-speed timeouts
git config --global core.compression 9
git config --global http.postBuffer 524288000
# npm: retries, offline preference
npm config set fetch-retries 5
npm config set prefer-offline true
# pip: retries, timeout
pip config set global.retries 5
pip config set global.timeout 60Note: Global configs require explicit opt-in (
APPLY_GLOBAL_CONFIGS=true/-ApplyGlobalConfigs)
fast-download/
├── src/
│ ├── fast-download.sh # Universal Bash library
│ ├── fast-download.fish # Fish shell library
│ └── fast-download.nu # Nushell library
├── opencode/
│ ├── SKILL.md # OpenCode skill manifest ⭐
│ ├── FastDownload.psm1 # PowerShell module
│ ├── skill.json # Skill metadata
│ ├── instructions.md # Agent instructions
│ ├── references/ # Reference documentation
│ ├── test-skill.ps1 # Test script
│ └── PERFORMANCE_REPORT.md # Benchmarks
├── claude-code/
│ └── fast-download.md # Claude Code agent
├── codex/
│ └── fast-download.md # OpenAI Codex agent
├── continue/
│ └── fast-download.yaml # Continue.dev agent
├── cline/fast-download/
│ ├── .clinerules # Cline rules
│ ├── skill.json # Skill metadata
│ └── instructions.md # Instructions
├── cursor/fast-download/
│ ├── .cursorrules # Cursor rules
│ ├── skill.json # Skill metadata
│ └── instructions.md # Instructions
├── vscode/fast-download/
│ ├── package.json # VS Code extension manifest
│ ├── extension.js # Extension entry point
│ ├── skill.json # Skill metadata
│ └── instructions.md # Instructions
├── windsurf/fast-download/
│ ├── .windsurfrules # Windsurf rules
│ ├── skill.json # Skill metadata
│ └── instructions.md # Instructions
├── jetbrains/
│ └── fast-download.md # JetBrains AI agent
├── amazon-q/
│ └── fast-download.md # Amazon Q agent
├── warp/
│ └── fast-download.yaml # Warp agent
├── scripts/
│ ├── install.ps1 # PowerShell installer (Windows)
│ ├── install.sh # Bash installer (Linux/macOS/WSL)
│ ├── uninstall.ps1 # PowerShell uninstaller
│ ├── uninstall.sh # Bash uninstaller
│ ├── create-demo.sh # Demo script
│ ├── fast-download.js # JS utilities
│ ├── install.js # Node installer
│ └── test.sh # Test suite
├── packaging/
│ └── aur/ # Arch Linux AUR package (PKGBUILD)
├── docs/
│ ├── AGENT_SETUP.md # Detailed agent setup guide
│ └── PERFORMANCE_REPORT.md # Benchmarks & methodology
├── assets/
│ └── logo.png # Project logo
├── .github/ # GitHub configuration
│ ├── workflows/ # CI/CD pipelines
│ │ ├── ci.yml # Build & test workflow
│ │ └── release.yml # Release automation
│ ├── ISSUE_TEMPLATE/ # Issue templates
│ ├── PULL_REQUEST_TEMPLATE.md
│ └── SECURITY.md
├── SKILL.md # Root skill manifest (OpenCode) ⭐
├── package.json # Node.js package config
├── README.md # This file
├── LICENSE # License
├── CONTRIBUTING.md # Contribution guide
├── CODE_OF_CONDUCT.md # Code of conduct
└── CHANGELOG.md # Version history
| Platform | Requirements |
|---|---|
| Windows | Windows 10/11, PowerShell 5.1+, aria2, Git (optional) |
| Linux | Bash 4+, aria2, curl, Git (optional) |
| macOS | Bash 4+/zsh/fish, aria2, curl, Git (optional) |
| WSL | Same as Linux |
All shell libraries (bash, fish, nushell) and PowerShell module are dependency-free — they only call aria2c, curl, or git if available.
| Metric | Value |
|---|---|
| Max parallel connections | 16 (aria2) / 4 (rate-limited) |
| Resume support | ✅ Full (aria2 + curl) |
| Checksum algorithms | SHA256, MD5 |
| Git shallow clone | ✅ --depth=1 --filter=blob:none |
| Rate-limit fallback | ✅ Automatic (aria2 → curl) |
| Zero config | ✅ Works out of the box |
See PERFORMANCE_REPORT.md for detailed benchmarks.
Contributions welcome! See CONTRIBUTING.md for guidelines.
- Fork the repo
- Create a feature branch
- Run tests:
bash scripts/test.sh - Submit PR
License — see LICENSE for details.
Author: Abdullah Al Hadi
