Skip to content

About

fast-download — Universal download accelerator for AI coding agents

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Fast-Download

fast-download logo

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.

License Platform: Windows Download: aria2 Build Status Release Downloads Stars Forks Issues PRs Welcome Code Size Top Language Last Commit


The Problem

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

The Solution

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                  │
└────────────────────────────────────────────────────────────┘

Benchmarks (Windows 11, 1 Gbps line)

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

Quick Install

One-liner (PowerShell) — Windows

irm https://raw.githubusercontent.com/AbdullahAlHadi2589/Fast-Download/master/scripts/install.ps1 | iex

One-liner (Bash) — Linux/macOS/WSL

curl -fsSL https://raw.githubusercontent.com/AbdullahAlHadi2589/Fast-Download/master/scripts/install.sh | bash

Quick Agent Install

Easiest way: Copy the Github link and paste it into your AI coding agent (OpenCode, Claude Code, Cursor, etc.) — it will handle the installation automatically.

Manual

  1. Install aria2: winget install aria2.aria2 / brew install aria2 / apt install aria2
  2. Clone the repo or copy the relevant agent folder (see table above)
  3. Place files in your agent's config location
  4. Restart your agent

Supported Agents

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 ✅

Usage

After install, just use these patterns in any terminal:

Download large files (HTTP/HTTPS/FTP)

# 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"

Clone Git repositories

# 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.git

PowerShell Module (Windows)

Import-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

Universal Shell Library (Any POSIX Shell)

# 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

How It Works

Smart Tool Selection

┌────────────────────────────────────────────────────────────┐
│                      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)            │
└────────────────────────────────────────────────────────────┘

Built-in Verification

  • 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

Global Config Optimizations (Opt-in)

# 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 60

Note: Global configs require explicit opt-in (APPLY_GLOBAL_CONFIGS=true / -ApplyGlobalConfigs)


📁 Project Structure

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

Requirements

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.


Performance

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.


Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

  1. Fork the repo
  2. Create a feature branch
  3. Run tests: bash scripts/test.sh
  4. Submit PR

License

License — see LICENSE for details.

Author: Abdullah Al Hadi


Credits

  • aria2 — The powerful download utility that makes this possible
  • OpenCode — For the skill architecture
  • All AI coding agent platforms that support extensibility

About

fast-download — Universal download accelerator for AI coding agents

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages