Command line interface written in Node.js to solve doubts during coding sessions.
You can search through Google as well as Stackoverflow from the terminal itself and open the required search result from the terminal in a new browser window. You will also have the option to save/bookmark any result for future reference.
The user has options to load the saved results and modify/delete them as well as open the required links from the saved results from the terminal itself.
Register a Google Search API Key here
(No API Key required for Stackoverflow)
It is highly recommended that you use PostgreSQL database to unlock all the capabilities of scout. The database may be on localhost or provided by Cloud providers like AWS (AWS RDS). Cloud-based host for database (like AWS RDS) will ensure that your saved/bookmarked results will be in sync across all your devices.
npm i @adi611/scout
npx @adi611/scout@latest
@latest
ensures that always the latest version of the package will be used.
npm install
npm link
Run scout key set
and it will ask you for your Google Search API Key. Enter it.
For PostgreSQL setup (required for save/bookmark feature), run scout db set
. It will then ask you for your host/endpoint
, port
, database name
, username
and password
. Enter these details.
# Help & Commands
scout -h
# Version
scout -V
# API Key Commands
scout key set # Set API key
scout key show # Show API Key
scout key remove # Remove API key
# DB Commands
scout db set # Set-up PostgreSQL database
scout db show # Show cuurent PostgreSQL database configuration
# Search Commands
scout search web --text "text-to-search" # Web Search
scout search sof --text "text-to-search" # Stackoverflow Search
# Saved/Bookmarked Result Commands
scout saved show # Show the saved/bookmarked results
scout saved delete --id <id> # Delete the saved/bookmarked result(s)
Unit tests for the CLI is written with Jest, and can be found under the tests
directory. To run the tests:
npm test
This CLI is automatically published through CD to npm using Github Actions on every push, and also supports CI of pull requests after running unit tests with Jest.