A blazing fast TUI download manager that supports multi-connection downloads, headless server modes, and complex queue management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install surge
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install surge using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Surge?
Surge is a high-performance terminal user interface (TUI) download manager designed to maximize bandwidth efficiency and speed. As a key utility within the ecosystem of Openclaw Skills, it offers advanced multi-connection capabilities, allowing for up to 32 parallel connections per file. This results in download speeds significantly faster than traditional tools like curl or wget.
The tool is architected to support both interactive and automated workflows. It provides a rich TUI for users who prefer visual management within the terminal, alongside a robust server mode that acts as a headless daemon. This versatility makes it an excellent choice for developers managing large datasets, automated build environments, or anyone needing reliable, high-speed file transfers.
Surge Use Cases
- Accelerating file downloads using parallel connection streams to maximize network throughput.
- Running a headless download daemon on remote servers for background file processing.
- Managing massive batches of URLs using text-based input files for automated scraping or data collection.
- Controlling and monitoring active download queues through an interactive terminal interface.
- Automating download tasks within larger workflows integrated with Openclaw Skills.
How Surge Works
- The user installs the Surge binary via package managers or Go installation scripts.
- The utility is launched either in TUI mode for manual control or server mode to run as a background process.
- URLs are added to the download queue via the CLI or the interactive interface.
- Surge initiates multi-connection requests to the source mirrors, splitting files into parts for faster retrieval.
- The tool manages the state of each download, allowing users to pause, resume, or prioritize tasks.
- Completed files are automatically moved to the specified output directory once all parts are successfully merged.
Surge Setup
To integrate Surge into your environment for Openclaw Skills, follow these installation steps:
# For macOS users via Homebrew
brew install surge-downloader/tap/surge
# For Go developers
go install github.com/surge-downloader/surge@latest
After installation, verify the setup by running surge --version. To begin a download immediately, use surge add "URL".
Surge Data Schema & Taxonomy
Surge organizes download tasks and metadata through a structured CLI and filesystem approach. Below is the organization of its primary data components:
| Component | Description | Default Value |
|---|---|---|
| Output Directory | Path where completed downloads are stored | ./downloads |
| Batch File | A plain text file containing a list of URLs | N/A |
| Server Host | The address for the headless daemon | localhost:9090 |
| API Token | Secure token for remote command execution | Generated via surge token |
| Task ID | Unique identifier for managing queue items | Numeric |
All configurations can be overridden using runtime flags to ensure compatibility with various Openclaw Skills automation scripts.
Surge Advanced Features
- Parallel connection engine supporting up to 32 simultaneous streams per download.
- Headless daemon mode (
surge server) for persistent, non-interactive download management. - Secure remote control using API tokens for managing downloads across different machines.
- Batch processing support to ingest hundreds of URLs from a single file with one command.
- Smart retry logic and error handling to recover from intermittent network interruptions.
- Performance-optimized core that benchmarks up to 2x faster than standard system utilities.
SKILL.md
Loading
Related Openclaw Skills
Skill Maker
A professional development framework designed to build, structure, and optimize reusable capabilities for AI agents.
Paper Compare
An advanced research tool that compares up to five academic papers side-by-side using DOIs, URLs, or PDF files to identify research gaps and methodology differences.
ImgBB API Skill
A powerful utility for programmatically uploading images to ImgBB and retrieving shareable direct links.
gallery-dl
A powerful command-line utility for downloading image galleries and collections from over 100 different websites.
OpenClaw-Last.fm
A powerful integration that connects Openclaw Skills to the Last.fm API for comprehensive music metadata and user listening statistics.
OpenClaw Finnhub
A specialized tool for fetching real-time US stock market quotes and financial data using the Finnhub API.
Featured*
