Ddg 1.0.0

Use ddgr (DuckDuckGo from the terminal) to perform privacy-focused web searches from the command line. Use when the user wants to (1) Search the web from the...

Security Scan

The skill is an instruction-only wrapper around the ddgr command‑line tool and the requested actions and artifacts align with that purpose.

Purpose & Capability

Name/description (ddgr/DuckDuckGo CLI) match the content: installation and usage instructions for ddgr. The skill declares no credentials, binaries, or config paths beyond typical shell changes; nothing requested is out of scope for a terminal search helper.

Instruction Scope

SKILL.md only describes installing ddgr (snap, PPA, or from source), running it, aliases, and common usage patterns. It does not instruct the agent to read unrelated files, exfiltrate data, or contact unknown endpoints. It does advise editing ~/.bashrc/~/ .zshrc and running commands with sudo for installation, which is normal for installing system packages.

Install Mechanism

This is an instruction-only skill with no built-in install spec. The README recommends snap, a PPA, or cloning the official GitHub repo (https://github.com/jarun/ddgr). Those are standard install paths for ddgr and are proportionate to the stated purpose.

Credentials

The skill requests no environment variables, secrets, or config paths. The only persistent change suggested is adding a shell alias to ~/.bashrc or ~/.zshrc, which is appropriate for a CLI convenience guide.

Persistence & Privilege

Flags show default privileges (not always:true). The skill does not request persistent always-on presence or attempt to modify other skills or system-wide agent settings. Installation instructions require normal package install privileges (sudo) which is expected.

Assessment

This skill is a documentation/instruction package for the ddgr command‑line tool. It asks you to install software (via snap, an apt PPA, or by building from the GitHub repo) and to add a shell alias — these are normal for a CLI helper. Before installing: verify you trust the PPA or GitHub source, review the repository (especially if you use 'sudo make install'), and be aware that installing system packages requires elevated privileges. No credentials or unusual system access are requested by this skill.

ddgr - DuckDuckGo from the Terminal

ddgr is a command-line utility to search DuckDuckGo from the terminal. It provides fast, privacy-focused web searches without opening a browser.

Installation

Via Snap (recommended for Ubuntu):

sudo snap install ddgr

Via PPA:

sudo add-apt-repository ppa:twodopeshaggy/jarun
sudo apt-get update
sudo apt-get install ddgr

From source:

git clone https://github.com/jarun/ddgr.git
cd ddgr
sudo make install

Dependencies: Python 3.8 or later

Basic Usage

Simple search (non-interactive):

snap run ddgr "search query" --np

Search with specific number of results:

snap run ddgr "search query" --num 5 --np

Search with time limit:

snap run ddgr "query" --time w --np    # past week
snap run ddgr "query" --time m --np    # past month
snap run ddgr "query" --time y --np    # past year

Site-specific search:

snap run ddgr "query" --site github.com --np

JSON output:

snap run ddgr "query" --json --np

Open first result in browser:

snap run ddgr "query" --ducky

Interactive Mode

Run without --np to enter interactive mode:

snap run ddgr "search query"

Interactive commands:

• 1, 2, 3... → open result in browser
• n → next page of results
• p → previous page of results
• q or Ctrl+D → quit
• ? → show help

Advanced Options

Option	Description
-n N, --num N	Show N results per page (0-25, default 10)
-r REG, --reg REG	Region-specific search (e.g., 'us-en', 'uk-en')
-t SPAN, --time SPAN	Time limit: d (day), w (week), m (month), y (year)
-w SITE, --site SITE	Search specific site
-x, --expand	Show complete URLs
--json	Output in JSON format
--ducky	Open first result in browser
--np, --noprompt	Non-interactive mode
--unsafe	Disable safe search

DuckDuckGo Bangs

Use DuckDuckGo bangs to search specific sites:

snap run ddgr "!w Linux" --np        # Wikipedia search
snap run ddgr "!yt music" --np       # YouTube search
snap run ddgr "!gh python" --np      # GitHub search
snap run ddgr "!a books" --np        # Amazon search

Make it Easier with an Alias

Add to ~/.bashrc or ~/.zshrc:

alias ddg='snap run ddgr'

Then use:

ddg "search query" --np

Privacy Features

• No user tracking or profiling
• Do Not Track enabled by default
• Works over Tor network (with proxy)
• HTTPS proxy support
• No stored search history

Examples

Search for tech news:

snap run ddgr "latest AI news 2025" --num 5 --np

Find Ubuntu tutorials:

snap run ddgr "Ubuntu tutorial" --site askubuntu.com --np

Search recent Python documentation:

snap run ddgr "Python 3.12 features" --time m --np

Use bang to search Wikipedia:

snap run ddgr "!w OpenClaw" --np

Troubleshooting

Command not found:

• Ensure ddgr is installed via snap: sudo snap install ddgr
• Use full command: snap run ddgr instead of just ddgr

No results:

• Check internet connection
• Try without --np to see if interactive mode works
• Verify DuckDuckGo is accessible in your region

Slow response:

• DuckDuckGo HTML interface can be slower than main site
• Use --time to limit results by time for faster queries

More Information

• GitHub: https://github.com/jarun/ddgr
• DuckDuckGo: https://duckduckgo.com
• Bangs: https://duckduckgo.com/bang