darkelf-cli 0.2.4

Privacy-focused OSINT CLI browser over Tor

Darkelf CLI Browser

A lightweight, privacy-focused terminal browser.

Darkelf CLI Browser lets you search, browse, and investigate data directly from your terminal with a clean, keyboard-driven interface—no GUI required.

---

🚀 Features

• 🌐 CLI Web Browser Navigate web pages directly from the terminal with keyboard controls.

• 🔍 Search Integration Perform DuckDuckGo searches and browse results in a structured, readable format.

• 📄 Readable Output Clean, structured display inspired by OSINT AI tools.

• ⌨️ Keyboard Navigation Fast, efficient navigation without leaving the terminal.

---

📦 Installation

pip install darkelf-cli

Or install locally for development:

pip install -e .

---

▶️ Usage

Run the tool:

darkelf-cli

---

🧭 Browser Controls

Key	Action
↑ / ↓ / w / s / j / k	Scroll page
O	Open link by number
U	Enter URL
B	Go back
H	View history
T	Manage tabs
F	Search
L	List links
M	Toggle Markdown view
/	Search within page
N	Next match
?	Help menu
Q	Quit browser

---

🔍 Example

Search for a term:

Enter search query: hello

Navigate results:

[1] HELLO - WIKIPEDIA
    A greeting used in everyday language...
    https://en.wikipedia.org/wiki/Hello

Press:

O → 1

To open the result.

---

⚠️ Disclaimer

This tool is intended for:

• educational purposes
• ethical OSINT investigations

Do not use it for illegal activities.

---

🛠️ Development

Project structure:

darkelf/
├── darkelf/
│   ├── __init__.py
│   └── cli.py
├── pyproject.toml
└── README.md

---

📌 Roadmap

• Improved parsing for search engines
• Async page loading
• Enhanced OSINT modules
• Better UI/UX rendering
• Plugin system

---

👤 Author

Dr. Kevin Moore

---

📄 License

This project is licensed under the GNU Lesser General Public License v3.0 (LGPL-3.0).

You are free to use, modify, and distribute this software under the terms of the LGPL-3.0 license.

See the LICENSE file for full details.