Skip to content

Basic Commands

Jump to bottom
Dragon edited this page Dec 22, 2025 · 3 revisions 
# 📖 Basic Commands Reference

Complete reference of all NaviDuck commands with examples and explanations. Bookmark this page for quick reference!

## 📋 Command Quick Reference

### **Legend**
| Symbol | Meaning |
|--------|---------|
| `[ ]` | Optional parameter |
| `< >` | Required parameter |
| `\|` | OR (choose one) |
| `...` | Multiple items allowed |

---

## 🚀 Essential Commands

### **Search Commands**

| Command | Shortcut | Description | Example |
|---------|----------|-------------|---------|
| `search [engine] <query>` | `s <query>` | Search the web | `s python tutorial` |
| `search google <query>` | - | Search using Google | `search google cats` |
| `search wikipedia <query>` | - | Search Wikipedia | `search wikipedia ai` |
| `search brave <query>` | - | Search using Brave | `search brave privacy` |
| `search ddg <query>` | - | Search DuckDuckGo | `search ddg linux commands` |

**Examples:**
```bash
# Quick search (uses default engine)
s how to learn python

# Search with specific engine
search wikipedia machine learning
search google latest news

# Multiple word queries
s "python web scraping tutorial"
search brave "best privacy tools"

Navigation Commands

Command Description Example
go <url> Visit a website go example.com
open <url|#> Open in system browser open github.com
back Go to previous page back
forward Go to next page forward
refresh Reload current page refresh
home Go to homepage home

Examples:

# Visit websites
go github.com
go https://python.org
go news.ycombinator.com

# Open in your default browser
open wikipedia.org
open 3          # Opens 3rd result from last search
open o3         # Same as above

# Navigation
back            # Go back to previous page
forward         # Go forward (after using back)
refresh         # Reload current page

AI Assistant Commands

Command Description Example
ai <question> Ask NavAI anything ai what is python
ai help Get AI help ai help
ai time Get current time ai time
ai date Get current date ai date

Examples:

# General questions
ai what is artificial intelligence
ai who created python
ai explain quantum computing

# Practical questions
ai how to install python on windows
ai best python libraries for data science
ai python vs javascript comparison

# Fun queries
ai tell me a joke
ai what is the meaning of life
ai roll a dice
ai flip a coin

# Simple queries
ai hello
ai how are you
ai thank you
ai bye

📚 Data Management Commands

History Commands

Command Description Example
history Show browsing history history
history clear Clear history history clear
history save Save history to file history save

Examples:

# View history
history

# Clear history (with confirmation)
history clear

# Navigate history from list:
# 1. Run `history`
# 2. Type number (1-15) to revisit
# 3. Or press Enter to return

Bookmark Commands

Command Description Example
bookmarks List all bookmarks bookmarks
bookmark add <url> Add bookmark bookmark add python.org
bookmark delete <#> Delete bookmark bookmark delete 3
bookmark export Export bookmarks bookmark export
bookmark import <file> Import bookmarks bookmark import bookmarks.json

Examples:

# View bookmarks
bookmarks

# Add bookmark (while viewing a page, press 'b')
# Or from command line:
bookmark add https://github.com

# Delete bookmark
bookmarks        # See list, note number
bookmark delete 2

# Quick bookmark from search results
# After search, type 'b' to bookmark first result

Page Actions (When viewing a page)

When viewing any webpage, these actions are available:

Key Command Description
b Bookmark Bookmark current page
o Open Open in system browser
s Search Search for related content
h History Go to history
q Quit Return to main menu

Usage: When viewing page content, you'll see these options at the bottom. Just press the letter.

⚙️ Settings & Configuration

Settings Commands

Command Description Example
settings Open settings menu settings
engines Manage search engines engines
tor <start|stop|status> Control Tor tor start
clear Clear screen clear
theme <light|dark|auto> Change theme theme dark

Examples:

# Open settings menu
settings

# Tor control
tor start        # Start Tor for anonymous browsing
tor stop         # Stop Tor
tor status       # Check Tor status

# Clear terminal
clear

# In settings menu:
# 1 - Change default search engine
# 2 - Manage search engines (enable/disable)
# 3 - Toggle icons (Emoji/Nerd Font)
# 4 - Set Tor path manually
# 5 - Clear history
# 6 - Clear bookmarks
# 7 - Back to main

Search Engine Management

From engines command:

Command Description Example
enable <#> Enable search engine enable 2
disable <#> Disable search engine disable 3
set <#> Set as default set 1
list List all engines list
back Return to main back

Examples:

# Open engine management
engines

# Then use these commands:
enable 1     # Enable engine #1
disable 2    # Disable engine #2  
set 3        # Set engine #3 as default
list         # Show all engines
back         # Return to main menu

🔧 System & Utility Commands

System Commands

Command Description Example
quit Exit NaviDuck quit
exit Exit NaviDuck exit
q Quick exit q
^X Immediate exit ^X
version Show version version
status Show system status status
config Show configuration config
update Check for updates update

Examples:

# Exit commands
quit        # Graceful exit
exit        # Same as quit
q           # Quick exit
^X          # Immediate exit (Ctrl+X)

# System info
version     # Show NaviDuck version
status      # Show current status
config      # Show configuration
update      # Check for updates

Help Commands

Command Description Example
help Show this help help
help search Search help help search
help ai AI help help ai
help commands List all commands help commands
help shortcuts Keyboard shortcuts help shortcuts
help examples Usage examples help examples

Examples:

# General help
help

# Specific help topics
help search      # Search command help
help ai          # AI command help
help commands    # List all commands
help shortcuts   # Keyboard shortcuts
help examples    # Usage examples

🎮 Interactive Command Examples

Complete Workflow Examples

Example 1: Research a Topic

# 1. Search for information
s python machine learning libraries

# 2. Ask AI for summary
ai best python ml libraries 2024

# 3. Visit a promising result
#    (Type number from search results)

# 4. Bookmark useful page
#    (When viewing page, press 'b')

# 5. Search for more info
s scikit-learn tutorial

# 6. Open documentation in browser
open scikit-learn.org

Example 2: Daily Browsing

# 1. Check news
s tech news today

# 2. Check social media
go twitter.com

# 3. Search for something specific
search google python new features

# 4. Get quick answer from AI
ai python 3.11 new features

# 5. Bookmark interesting page
#    (Press 'b' when viewing)

# 6. Check history of today's browsing
history

Example 3: Learning Session

# 1. Learn about a concept
ai explain rest api

# 2. Search for tutorials
s rest api tutorial python

# 3. Visit documentation
go restfulapi.net

# 4. Search for examples
search github rest api examples

# 5. Bookmark resources
#    (Bookmark multiple pages with 'b')

# 6. Review bookmarks
bookmarks

⌨️ Keyboard Shortcuts

Global Shortcuts

Shortcut Command Description
Ctrl+X ^X Immediate exit
Ctrl+C - Cancel current operation
Tab - Auto-completion (where available)
↑ ↓ - Command history navigation

Search Results Screen

Key Action Description
1-10 Open Open result in NaviDuck
o1-o10 Open external Open in system browser
b Bookmark Bookmark first result
Enter Return Return to search
q Quit Return to main

Page View Screen

Key Action Description
b Bookmark Bookmark current page
o Open Open in system browser
s Search Search related content
h History View history
q Return Return to main
Enter Continue Continue reading

History/Bookmarks Lists

Key Action Description
1-15 Open Open item
d-# Delete Delete item (bookmarks)
Enter Return Return to main

🔄 Command Combinations

Chaining Commands

# Search then immediately ask AI
s python && ai what is python used for

# Visit site then search related
go github.com && s open source projects

# Check status then clear
status && clear

Quick Actions

# Quick lookup and open
ai python documentation && open 1

# Research and bookmark
s python tutorial && b

# Daily routine
clear && s news && history

🎯 Command Categories by Use Case

For Beginners

help          # Always start here
s <query>     # Basic search
ai <question> # Ask questions
go <site>     # Visit websites
history       # See your history
quit          # Exit properly

For Power Users

search <engine> <query>  # Engine-specific search
tor start                # Anonymous browsing
engines                  # Manage search engines
bookmark export          # Export bookmarks
^X                       # Quick exit

For Developers

s api documentation      # Quick docs lookup
ai code example          # Get code examples
go stackoverflow.com     # Visit dev sites
open github.com          # Open in browser
bookmark add <dev-url>   # Save dev resources

For Researchers

search wikipedia <topic> # Academic search
ai explain <concept>     # Get explanations
s academic paper <topic> # Find papers
bookmark add <paper>     # Save references
history                  # Track research

❓ Common Command Questions

"How do I search with a specific engine?"

# Method 1: Use full command
search google your query
search wikipedia your topic

# Method 2: Change default engine in settings
settings  # Then option 1

"How do I bookmark a page?"

# Method 1: When viewing page, press 'b'
# Method 2: From command line
bookmark add https://example.com

# Method 3: From search results, type 'b'

"How do I open a link in my browser?"

# Method 1: From command line
open https://example.com

# Method 2: From search results
# Type o1, o2, o3... (o for "open")

# Method 3: When viewing page, press 'o'

"How do I exit quickly?"

quit     # Graceful exit
q        # Quick exit
^X       # Immediate exit (Ctrl+X)

"How do I clear my history?"

# Method 1: From settings
settings  # Then option 5

# Method 2: Direct command
history clear

📝 Command Syntax Rules

Quoting Rules

# Single words don't need quotes
s python

# Multiple words work without quotes
s python tutorial beginners

# Use quotes for special characters
s "python -m pip install"
s "what's new in python 3.11"

# Use quotes to preserve exact phrase
s "machine learning algorithms"

URL Rules

# HTTP/HTTPS optional
go example.com        # Works
go https://example.com  # Also works

# No www needed
go github.com         # Works
go www.github.com     # Also works

# Subdomains work
go docs.python.org    # Works

Number Arguments

# For opening results
open 1      # Opens 1st result
open o1     # Same as above
open 3      # Opens 3rd result

# For bookmarks/history
# First view list, then use numbers
bookmarks   # See numbers
bookmark delete 2  # Delete bookmark #2

history     # See numbers
# Type number to open from history

🚨 Error Messages & Solutions

Common Errors

Error Solution
Command not found Check spelling or use help
No results found Try different search terms
Connection failed Check internet or try later
Invalid URL Add https:// or check spelling
Permission denied Check file permissions

Troubleshooting Commands

# If command doesn't work:
help                  # Check correct syntax
ai help               # Ask AI for help
clear                 # Clear any display issues
quit && python naviduck.py  # Restart NaviDuck

📊 Command Usage Statistics

(Based on typical user patterns)

Most Used Commands

  1. s / search (45% of usage)
  2. ai (25% of usage)
  3. go (15% of usage)
  4. open (8% of usage)
  5. history (4% of usage)
  6. Other commands (3% of usage)

Recommended Learning Order

  1. s, ai, go - Basic navigation
  2. open, history, bookmarks - Data management
  3. settings, engines - Customization
  4. tor, clear, quit - System control
  5. All other commands - Advanced features

🎓 Command Proficiency Levels

Level 1: Beginner (Know 5 commands)

  • ✅ s / search
  • ✅ ai
  • ✅ go
  • ✅ help
  • ✅ quit

Level 2: Intermediate (Know 10 commands)

  • ✅ All Beginner commands
  • ✅ open
  • ✅ history
  • ✅ bookmarks
  • ✅ settings
  • ✅ clear

Level 3: Advanced (Know 15+ commands)

  • ✅ All Intermediate commands
  • ✅ tor
  • ✅ engines
  • ✅ Specific engine searches
  • ✅ Bookmark management
  • ✅ All page actions

Level 4: Expert (Know all commands)

  • ✅ All commands
  • ✅ Keyboard shortcuts
  • ✅ Command combinations
  • ✅ Troubleshooting
  • ✅ Teaching others

📱 Mobile/Tablet Considerations

Touchscreen-Friendly Commands

# Shorter is better on mobile
s <query>     # Instead of search
ai <q>        # Short questions
go <site>     # Short URLs
q             # Quick exit

Voice Input Tips

# For voice-to-text, say:
"search python"
"ai what is machine learning"
"go github.com"
"open number 1"

🔄 Command Updates

New in Latest Version

  • ^X - Immediate exit command
  • tor - Enhanced Tor control
  • theme - Theme switching
  • update - Update checker

Deprecated Commands

(None currently - all commands are supported)

Planned Future Commands

  • plugin - Plugin management
  • script - Run scripts
  • share - Share results
  • translate - Translation features

📚 Related Resources

💡 Pro Tips

  1. Use Tab completion where available
  2. Chain commands with && for workflows
  3. Bookmark this page for quick reference
  4. Use help when unsure about a command
  5. Try ai help for context-aware assistance

❓ Still Need Help?

  • Use help within NaviDuck
  • Ask ai help for AI assistance
  • Visit FAQ for common questions
  • Check Discussions for community help
  • Review Troubleshooting for solutions

"The more commands you know, the more powerful NaviDuck becomes!"

# Try a new command now:
help shortcuts
# or
ai what command should I learn next?

Happy commanding! 🦆💻

Last updated: {{CURRENT_DATE}}
Commands reference version: 3.1


This comprehensive commands reference page includes:
1. Complete command listing with examples
2. Organized by category and use case
3. Keyboard shortcuts
4. Common workflows
5. Troubleshooting tips
6. Proficiency levels for learning
7. Pro tips and best practices

Perfect for users to bookmark and reference whenever they need help with NaviDuck commands!

Clone this wiki locally