Ddg

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 terminal, (2) Perform DuckDuckGo searches without opening a browser, (3) Get quick search results in text format, (4) Search privately without tracking, (5) Use DuckDuckGo bangs (!) from terminal.

Security Scan

The skill is an instruction-only wrapper for the ddgr command-line DuckDuckGo client; its requirements and instructions align with that purpose and do not request unrelated credentials or elevated persistent privileges.

Purpose & Capability

Name/description map directly to the provided instructions for installing and using ddgr (DuckDuckGo CLI). The SKILL.md only references ddgr functionality (search flags, bangs, JSON output, proxies/Tor) and does not ask for unrelated services, credentials, or system access.

Instruction Scope

Runtime instructions are limited to installing ddgr (snap/PPA/from-source), running the ddgr command, using flags, and optionally adding a shell alias. There are no instructions to read arbitrary files, exfiltrate data, or contact unknown endpoints. The install steps do use sudo (normal for package install) and suggest proxy/Tor usage but do not include any extra config collection.

Install Mechanism

This is instruction-only (no automated install spec). Recommended install methods are standard (snap, distro PPA, GitHub repo). Cloning from GitHub (jarun/ddgr) is expected for building from source and is a well-known host; the skill does not perform any automatic downloads itself.

Credentials

The skill declares no required environment variables, credentials, or config paths. That matches the simple terminal-search purpose.

Persistence & Privilege

always:false and no install-time code means the skill does not demand permanent/system-wide presence or modify other skills. It is user-invocable and may be invoked autonomously by the agent (platform default), which is appropriate for this kind of helper.

Assessment

This skill is instruction-only and simply documents installing and using the ddgr CLI. Before installing, verify the install source you choose (snap, the PPA owner, or the GitHub repo jarun/ddgr) and only run install commands you trust. Installing via snap or apt/ppa requires sudo — review and trust the PPA. Building from source runs make install as root, so inspect the repo if you plan to use that path. Adding an alias to your shell rc is benign but changes your shell setup. If you plan to use Tor/proxy features, configure and verify your proxy/Tor client separately. No credentials are requested by the skill itself.

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