Do Wdr CLI

WDR CLI Skill

Fast compiled Rust CLI for resolving web URLs and queries into markdown documentation.

When to use this skill

Activate this skill when you need to:

• Resolve a URL or query to markdown from the command line
• Integrate documentation resolution into shell scripts
• Get faster performance than the Python implementation
• Use CLI-specific features (metrics, cache stats, provider selection)
• Build automation workflows with do-wdr

Prerequisites

Build the CLI first:

cd cli && cargo build --release
# Binary: cli/target/release/do-wdr

Or ensure do-wdr is in your PATH.

Commands

resolve

Resolve a URL or query to markdown documentation.

do-wdr resolve <INPUT> [OPTIONS]

Arguments:

• <INPUT>: URL or query string to resolve

Options:

• -o, --output <FILE>: Output file (stdout if not specified)
• -p, --provider <PROVIDER>: Specific provider to use
• --skip <PROVIDERS>: Skip providers (comma-separated)
• --providers-order <PROVIDERS>: Custom provider order
• --max-chars <N>: Maximum output characters
• --min-chars <N>: Minimum content length
• --profile <PROFILE>: Execution profile (free, balanced, fast, quality)
• --json: Output as JSON
• --metrics-json: Output metrics as JSON
• --metrics-file <FILE>: Save metrics to file
• --skip-cache: Skip semantic cache
• --synthesize: Synthesize multiple results using AI
• --quality-threshold <F>: Quality threshold for content scoring
• --max-provider-attempts <N>: Maximum provider attempts
• --max-paid-attempts <N>: Maximum paid provider attempts
• --max-total-latency-ms <MS>: Maximum total latency in milliseconds
• --disable-routing-memory: Disable routing memory

providers

List all available providers and their status.

do-wdr providers

config

Show current configuration.

do-wdr config

cache-stats

Show semantic cache statistics.

do-wdr cache-stats

Examples

Basic Usage

# Resolve a URL
do-wdr resolve "https://docs.rs/tokio/latest/tokio/"

# Resolve a query
do-wdr resolve "Rust async runtime comparison"

# JSON output
do-wdr resolve "Python web frameworks" --json

Provider Selection

# Use specific provider
do-wdr resolve "query" --provider exa_mcp

# Skip providers
do-wdr resolve "query" --skip tavily,serper

# Custom provider order
do-wdr resolve "query" --providers-order duckduckgo,exa_mcp,tavily

Output Options

# Save to file
do-wdr resolve "https://example.com" --output result.md

# JSON output to file
do-wdr resolve "query" --json --output results.json

# Include metrics
do-wdr resolve "query" --json --metrics-json

Performance Profiles

# Free tier only (no API keys needed)
do-wdr resolve "query" --profile free

# Balanced speed and quality
do-wdr resolve "query" --profile balanced

# Fast results
do-wdr resolve "query" --profile fast

# High quality results
do-wdr resolve "query" --profile quality

Advanced Features

# Synthesize multiple results
do-wdr resolve "query" --synthesize

# Skip cache
do-wdr resolve "query" --skip-cache

# Save metrics for analysis
do-wdr resolve "query" --metrics-file metrics.json

Available Providers

Execution Profiles

Output Format

Text Output (default)

Returns markdown content directly:

# Documentation Title

Content extracted from the URL...

JSON Output

{
  "url": "https://example.com/docs",
  "content": "# Documentation\n\n...",
  "source": "exa_mcp",
  "score": 0.87,
  "metrics": {
    "latency_ms": 1234,
    "providers_attempted": ["exa_mcp"],
    "cache_hit": false
  }
}

Configuration

Configuration is loaded from (in order):

1. CLI arguments
2. Environment variables
3. cli/config.toml
4. Defaults

Environment Variables

# Provider API keys (all optional)
export EXA_API_KEY="your_key"
export TAVILY_API_KEY="your_key"
export SERPER_API_KEY="your_key"
export FIRECRAWL_API_KEY="your_key"
export MISTRAL_API_KEY="your_key"

Verbose Logging

Use -v flags for debugging:

# Info level
do-wdr resolve "query" -v

# Debug level
do-wdr resolve "query" -vv

# Trace level
do-wdr resolve "query" -vvv

Integration with Scripts

#!/bin/bash
# Example: Resolve and process results

RESULT=$(do-wdr resolve "Rust web frameworks" --json)
echo "$RESULT" | jq '.content' > frameworks.md

# Use in pipeline
do-wdr resolve "API documentation" | grep -A5 "## Authentication"

Related Skills

• do-web-doc-resolver: Python implementation with same functionality
• agent-browser: Browser automation for complex web interactions