Skip to content

Command Reference

Dragon edited this page Dec 22, 2025 · 1 revision

⌨️ NaviDuck Command Reference

Last updated: 12/22/2025

🎯 Quick Command Finder

Search & Navigation

Command Shortcut Description Example
s [query] s Quick search s python tutorial
search [engine] [query] - Search with specific engine search google AI news
go [url] - Open URL in NaviDuck go https://github.com
open [url/#] o Open in system browser open 3 (opens 3rd result)

AI Assistant

Command Shortcut Description Example
ai [question] - Ask NavAI ai what is Python?
ai weather [city] - Weather information ai weather Tokyo
ai time [city] - Current time ai time London

Data Management

Command Shortcut Description
history h View browsing history
bookmarks b Manage bookmarks
settings - Open settings menu
engines - Manage search engines

System Control

Command Shortcut Description
tor start - Start Tor connection
tor stop - Stop Tor connection
tor status - Check Tor status
clear cls Clear screen
help ? Show help
quit q, exit, ^X Exit NaviDuck

🔍 Search Commands (Detailed)

Basic Search

# Quick search (uses default engine)
s python programming

# Search with specific engine
search brave linux commands
search google machine learning
search ddg privacy tools
search wikipedia ancient rome
search ddg_api quick facts

# With special characters
s "exact phrase search"
s python -java  # Exclude terms

Advanced Search Operators

# Site-specific search
search google site:github.com python
search ddg site:wikipedia.org "machine learning"

# File type search
search google filetype:pdf python tutorial
search brave filetype:md documentation

# Date range (when supported)
search google python 2023..2024

Result Navigation

# After search results appear:
1-10        # Open result in NaviDuck
o1-o10      # Open result in system browser
b           # Bookmark first result
n           # Next page (if available)
p           # Previous page

Engine-Specific Syntax

# DuckDuckGo !bang commands
search ddg !w python          # Wikipedia
search ddg !yt python tutorial # YouTube
search ddg !g python          # Google
search ddg !so python error   # Stack Overflow

# Google operators
search google intitle:python filetype:py
search google inurl:github python

🤖 AI Commands (Detailed)

General Knowledge

# Basic questions
ai what is artificial intelligence?
ai explain quantum computing
ai who invented the internet?

# Technical questions
ai how does HTTPS work?
ai difference between TCP and UDP
ai what is REST API?

# Practical information
ai current time in New York
ai weather forecast Paris
ai convert 100 USD to EUR

Math & Calculations

# Calculations
ai calculate 15% of 200
ai 2+2*2
ai square root of 144

# Conversions
ai convert 10 miles to kilometers
ai 100 degrees Fahrenheit to Celsius

Programming Help

# Code examples
ai show me python hello world
ai how to read file in python
ai javascript array methods

# Debugging help
ai python syntax error unexpected indent
ai fix this code: [paste code]

Definitions & Explanations

# Definitions
ai define algorithm
ai what is blockchain
ai explain recursion

# Comparisons
ai python vs javascript
ai git vs svn
ai http vs https

Fun & Miscellaneous

# Fun queries
ai tell me a joke
ai roll a dice
ai flip a coin
ai random number 1-100

# System info
ai what is my IP address
ai is my internet working

🌐 Navigation Commands

URL Navigation

# Open websites
go https://github.com
go https://news.ycombinator.com
go wikipedia.org  # Auto-adds https://

# .onion sites (requires Tor)
go http://example.onion

# Local files (experimental)
go file:///path/to/file.html

History Navigation

# View history
history

# Navigate history
history 5    # Open 5th item
history back # Go back (if supported)

Tab-like Navigation

# While viewing a page:
s          # Search related to current page
b          # Bookmark current page
o          # Open current page in browser
h          # Go to history
q          # Back to main menu

📚 Bookmark Commands

Bookmark Management

# View bookmarks
bookmarks

# Bookmark current page
# While viewing page: press 'b', then enter title

# Bookmark from search results
# After search: type 'b' to bookmark first result

# Open bookmark
bookmarks 3  # Open 3rd bookmark

Bookmark Organization

# Tag bookmarks (future feature)
bookmark add tag programming
bookmark search tag:python

# Export bookmarks (planned)
bookmarks export bookmarks.json
bookmarks import bookmarks.json

⚙️ Settings Commands

Configuration

# Open settings menu
settings

# Quick settings changes
settings engine brave      # Change default engine
settings emoji true        # Use emoji icons
settings timeout 15        # Set network timeout

Engine Management

# List available engines
engines

# Enable/disable engines
engines enable 1
engines disable 2
engines set 3    # Set as default

# Engine status
engines status   # Show which engines are working

Privacy Settings

# Tor control
tor start        # Start Tor
tor stop         # Stop Tor
tor status       # Check status
tor newid        # New identity (planned)

# Privacy features
settings privacy high     # Maximum privacy mode
settings privacy normal   # Balanced mode
settings privacy low      # Performance mode

Data Management

# Clear data
settings clear history    # Clear browsing history
settings clear cache      # Clear search cache
settings clear all        # Clear all data

# Import/export
settings export config.json
settings import config.json

🔧 System Commands

Performance & Debugging

# Performance info
stats          # Show statistics (planned)
profile        # Performance profile (planned)

# Debug mode
debug on       # Enable debug output
debug off      # Disable debug output
debug network  # Network debugging

# Logs
logs show      # View logs (planned)
logs clear     # Clear logs

Update & Maintenance

# Check for updates
update check    # Check for new version
update install  # Install update (planned)

# System info
version         # Show version
system info     # System information
deps check      # Check dependencies

Session Management

# Save/load sessions
session save work      # Save current session as "work"
session load work      # Load "work" session
session list           # List saved sessions
session delete work    # Delete session

🎨 UI & Display Commands

Theme & Appearance

# Toggle icon sets
theme nerd      # Use Nerd Font icons
theme emoji     # Use emoji icons
theme auto      # Auto-detect

# Color themes
theme dark      # Dark theme
theme light     # Light theme
theme auto      # Auto theme

# Display options
theme compact   # Compact display
theme detailed  # Detailed display
theme minimal   # Minimal display

Screen Management

# Clear screen
clear
cls     # Alternative

# Refresh display
refresh

# Toggle fullscreen
fullscreen    # Toggle (planned)

Keyboard Shortcuts

# Show shortcuts
shortcuts
keys
? all          # Show all commands

# Customize shortcuts
shortcut add s search
shortcut remove s

📁 File & Data Commands

Local File Operations

# Save content
save page      # Save current page
save results   # Save search results
save config    # Save configuration

# Load content
load file.html # Load local file
load query.txt # Load search queries from file

# Export data
export json    # Export as JSON
export csv     # Export as CSV
export html    # Export as HTML

Content Processing

# Extract content
extract text   # Extract text from page
extract links  # Extract all links
extract images # Extract images (planned)

# Filter content
filter ads     # Remove ads
filter clean   # Clean formatting
filter summary # Create summary

🔌 Plugin & Extension Commands

Plugin Management (Planned)

# Plugin commands
plugin list          # List installed plugins
plugin install name  # Install plugin
plugin remove name   # Remove plugin
plugin update all    # Update all plugins

# Plugin development
plugin create name   # Create new plugin
plugin test name     # Test plugin
plugin publish name  # Publish plugin

Extension Points

# Search plugins
engine add custom    # Add custom engine
engine remove name   # Remove engine

# UI extensions
theme install name   # Install theme
theme preview name   # Preview theme

🌐 Network Commands

Connection Management

# Network status
network status      # Check connection
network test        # Test connectivity
network speed       # Speed test (planned)

# Proxy configuration
proxy set http://proxy:8080
proxy clear
proxy test

DNS & Security

# DNS settings
dns 1.1.1.1         # Set DNS server
dns clear           # Clear custom DNS
dns test            # Test DNS

# Security checks
security scan       # Security scan (planned)
ssl verify          # Verify SSL certificates

🛠️ Development & Debug Commands

Developer Tools

# Debug mode
--debug             # Start with debug flag
debug console       # Open debug console
debug network       # Network debugging

# Testing
test unit           # Run unit tests
test integration    # Integration tests
test all            # All tests

# Code quality
lint                # Check code style
typecheck           # Type checking (planned)

API Testing

# API endpoints
api search test     # Test search API
api ai test         # Test AI API
api status          # API status

# Rate limiting
limit status        # Check rate limits
limit reset         # Reset counters

📊 Statistics & Analytics

Usage Statistics

# View stats
stats daily         # Daily statistics
stats weekly        # Weekly summary
stats top queries   # Most common searches

# User analytics
stats engines       # Engine usage
stats time          # Time spent
stats success       # Success rate

Performance Metrics

# Speed metrics
speed search        # Search speed
speed ai            # AI response speed
speed network       # Network speed

# Resource usage
memory              # Memory usage
cpu                 # CPU usage
storage             # Storage usage

🚨 Emergency & Recovery

Emergency Commands

# Immediate actions
^X                  # Ctrl+X: Immediate quit (anywhere)
panic               # Emergency shutdown (planned)

# Data protection
encrypt             # Encrypt data (planned)
backup              # Create backup
wipe                # Secure wipe (planned)

Recovery Commands

# Data recovery
restore backup.json # Restore from backup
repair              # Repair corrupted data
reset               # Factory reset

# System recovery
reinstall           # Reinstall dependencies
verify              # Verify installation

🎮 Interactive Modes

Interactive Search

# Enter search mode
/search
# Then type queries without 's' prefix
python tutorial
exit    # Exit search mode

Batch Mode

# Execute multiple commands
batch commands.txt

# Command file example:
s python
open 1
b
s javascript

Script Mode

# Run as script
naviduck --script automate.nv

# Script example:
SET ENGINE brave
SEARCH "python web scraping"
WAIT 2
OPEN 1
SAVE page.html

🔄 Command Aliases

Common Aliases

# Search aliases
/? [query]         # Alias for 's'
find [query]       # Alias for 'search'

# Navigation aliases
navigate [url]     # Alias for 'go'
browse [url]       # Alias for 'open'

# System aliases
exit               # Alias for 'quit'
cls                # Alias for 'clear'
?                  # Alias for 'help'

Custom Aliases (Planned)

# Create aliases
alias gs "search google"
alias wp "search wikipedia"

# List aliases
alias list

# Remove alias
alias remove gs

📝 Command Syntax Rules

General Syntax

command [subcommand] [arguments] [options]

Argument Types

# Strings (with or without quotes)
s python tutorial
s "python tutorial"

# Numbers
open 3
history 5

# Boolean flags
--debug
--no-cache

# Key-value pairs
--timeout=10
--engine=brave

Special Characters

# Quotes for phrases
s "machine learning algorithms"

# Escape special characters
s python\ tutorial  # Backslash escape
s python\\tutorial  # Literal backslash

# Unicode support
s python 🐍
s café

🎯 Command Examples by Use Case

For Researchers

# Academic research
search scholar "deep learning"
search wikipedia "quantum mechanics"
search arxiv "neural networks"  # If added

# Save research
s "research papers" | save papers.txt
bookmark add "Important Paper" https://arxiv.org/...

For Developers

# Code search
search github "python flask example"
search stackoverflow "python error"
search npm "react component"

# Documentation
ai "python list comprehension"
go docs.python.org

For Privacy-Conscious Users

# Private browsing
tor start
search ddg "private search"
go http://privacy.onion

# Clean up
settings clear history
settings privacy high

For Students

# Study help
ai "explain photosynthesis"
search wikipedia "world war II"
ai "math homework help"

# Organization
bookmark add "Study Notes" https://...
session save "math_class"

For News & Updates

# News search
search news "technology"
search reddit "python"
search hackernews

# RSS feeds (planned)
rss add https://news.com/feed
rss read

🔍 Command Search & Discovery

Finding Commands

# Search commands
help search        # Search-related commands
help ai            # AI commands
help privacy       # Privacy commands

# Show all commands
help all
commands
list

# Command suggestions
help "book"        # Shows bookmark commands

Command History

# View command history
history commands   # Command history
!!                 # Repeat last command
!s                 # Repeat last search
!ai                # Repeat last AI query

Context-Sensitive Help

# Get help for current context
# In search results: help
# While viewing page: help
# In settings: help

# Show available actions
actions
what can I do?

🚀 Productivity Tips

Quick Commands

# One-letter commands (where available)
s    # Search
q    # Quit
b    # Bookmarks
h    # History
c    # Clear

Command Combinations

# Chain commands with ;
s python; open 1; b

# Background operations
search python &    # Search in background (planned)

# Pipes and redirects
s python > results.txt  # Save to file (planned)

Keyboard Shortcuts in Results

After search results:
─────────────────────────────────────
Number (1-10)  → Open in NaviDuck
o + Number     → Open in browser
b              → Bookmark first
n/p            → Next/previous page
q              → Back to main
─────────────────────────────────────

While Viewing Pages

On any page:
─────────────────────────────────────
b              → Bookmark page
o              → Open in browser
s              → Search related
h              → History
q              → Back to main
─────────────────────────────────────

🎮 Advanced Usage Patterns

Automation Scripts

#!/bin/bash
# automate_searches.sh
echo "s python tutorial" | naviduck
echo "s javascript framework" | naviduck
echo "q" | naviduck

Command Files

# searches.txt
s python web scraping
wait 2
open 1
s python data analysis
wait 2
open 1
quit

Integration with Other Tools

# Pipe to grep
naviduck --cmd "s python" | grep -i "tutorial"

# Use with curl
curl "https://api.example.com" | naviduck --process

# Schedule with cron
0 * * * * /path/to/naviduck --cmd "s news"

🆘 Getting Help

Built-in Help System

# Basic help
help
?

# Detailed help
help search
help ai
help settings

# Examples
help examples
tutorial

Error Messages

# Common errors and solutions
ERROR: "Command not found" → Check spelling or type 'help'
ERROR: "Network error" → Check connection or use 'tor start'
ERROR: "Engine failed" → Try 'search brave [query]'

Verbose Mode

# Get more information
--verbose
-v

# Debug output
--debug
-d

🔄 Command Updates

Recently Added Commands

v1.2.0: Added 'ai time [city]'
v1.1.0: Added 'tor newid'
v1.0.5: Added 'theme emoji/nerd'

Deprecated Commands

# Old syntax (still works but deprecated)
old_command → new_command

Experimental Commands

# Beta features (may change)
experimental on    # Enable experimental commands
experimental list  # List experimental features

Last updated: 12/22/2025
Command Reference version: 4.0

Quick Tip: Press Tab for command completion and ↑/↓ for command history in interactive mode!


🎯 Command Cheat Sheet (Printable)

┌─────────────────────────────────────────────────────────────┐
│                    NaviDuck Quick Reference                  │
├─────────────────────────────────────────────────────────────┤
│ SEARCH                                                     │
│   s [query]                    Quick search                │
│   search [engine] [query]      Search with engine         │
│   1-10                         Open result                │
│   o1-o10                       Open in browser            │
│   b                            Bookmark first result      │
├─────────────────────────────────────────────────────────────┤
│ AI                                                          │
│   ai [question]                Ask NavAI                  │
│   ai time [city]               Current time               │
│   ai weather [city]            Weather info               │
├─────────────────────────────────────────────────────────────┤
│ NAVIGATION                                                  │
│   go [url]                     Open URL                   │
│   open [url/#]                 Open in browser            │
│   history                      Browsing history           │
│   bookmarks                    Saved bookmarks            │
├─────────────────────────────────────────────────────────────┤
│ SYSTEM                                                      │
│   tor start/stop               Tor control                │
│   settings                     Configuration              │
│   engines                      Search engines             │
│   clear                        Clear screen               │
│   quit / q / ^X                Exit                       │
└─────────────────────────────────────────────────────────────┘

Remember: You can always type help or ? for assistance with any command!

Clone this wiki locally