dsh-vidfetch

Give your DeepSeek Harness agent the ability to download a video straight from a URL.

What it does

Registers a single tool, fetch_video, that the model can call to download the main video from any URL.

• Downloads the best available audio+video stream into the directory the agent specifies.
• Returns ok plus the list of files it wrote. Or a short error cause if the URL is unsupported.
• No configuration file or extra setup on the agent side: just point dir somewhere writable.

Installation

dsh plugin --profile web add dsh-vidfetch

From this repository:

git clone https://github.com/anaksunamu/dsh-vidfetch.git 
npm install --prefix ./dsh-vidfetch
npm run build --prefix ./dsh-vidfetc
dsh plugin --profile web add ./dsh-vidfetch

Usage

The model calls fetch_video with two required parameters:

Parameter	Type	Description
url	string	The URL where the video is located.
dir	string	Output directory for the downloaded file.

Example call the agent makes:

{ "url": "https://example.com/watch/abc123", "dir": "~/downloads" }

Output:

{ "message": "ok", "files": ["downloads/video.mp4"] }

On failure, message contains a short error cause and files is empty:

{ "message": "Unsupported URL", "files": [] }

Requirements

• DSH: tested against the 0.1.1-rc.x line.
• Node: ^22.19.0 || >=24.0.0.
• yt-dlp: provided by dependency.

Permissions & network

Clear the risk explicitly before trusting an agent tool:

• Outbound network: each call fetches whatever URL the model passes. The plugin sends no telemetry and contacts no external service of its own.
• Filesystem write: files land in the dir the model supplies (default: current working directory if empty). The model decides the path — point dir at a sandboxed or scratch folder if you don't want arbitrary writes.
• Subprocess: runs a yt-dlp process per call; it inherits the host's environment.
• Untrusted content warning: videos fetched from random URLs are untrusted files. Don't pipe them straight into execution pipelines.
• No API key required by this plugin.

License & listing

• License: MIT.
• Not affiliated with DeepSeek AI.
• Compatibility notes above are for DSH preview 0.1.1-rc.x.