Skip to main content

a command-line browser interface

Project description

a command-line browser interface

cliquery cuts down on clicking through command-line web searching, page previewing, and page bookmarking, among other features. An interactive prompt allows users to easily make successive queries and enter program flags dynamically; simply typing help will list all possible flags to enter. Opening a link will invoke a browser supplied by the user or detected automatically across Windows, OSX, and Linux platforms.


pip install cliquery --user


pip install git+ --user


git clone
cd cliquery
python install --user

If you encounter issues installing lxml, see here.

It is advised to copy the blank .cliqrc into .local.cliqrc, as .cliqrc will be emptied after a program update. To do this, enter the following:

cd "$(dirname "$(cliquery -c)")" && cp .cliqrc .local.cliqrc


usage: [-h] [-b] [-c] [-C] [-d] [-e] [-f] [-i [IMPORT]] [-o] [-p]
                   [-s] [-v] [-w]
                   [QUERY [QUERY ...]]

a command-line browser interface

positional arguments:
  QUERY                 keywords to search

optional arguments:
  -h, --help            show this help message and exit
  -b, --bookmark        view and modify bookmarks
  -c, --config          print config file location
  -C, --clear-cache     clear the cache
  -d, --describe        summarize links
  -e, --edit            edit config file
  -f, --first           open first link
  -i [IMPORT], --import [IMPORT]
                        import bookmarks from file
  -o, --open            directly open links
  -p, --print           print links to stdout
  -s, --search          search for links
  -v, --version         display current version
  -w, --wolfram         search WolframAlpha



  • NOTE: If you receive the following message (or similar) when trying to modify bookmarks:

    IOError: [Errno 13] Permission denied: '/usr/local/lib/python2.7/dist-packages/cliquery/.cliqrc'

    This means you did not follow the install advice and chose to install as root. You have three options:

    1. (recommended) Uninstall and reinstall as a non-root user by following the instructions above.
    2. Change the configuration file ownership from root to user by entering the following:
            sudo chown $USER "$(cliquery -c)"
    2. (not recommended) Execute cliquery as root, using su or sudo.
  • A search may return immediate results, such as calculations or facts made possible by WolframAlpha, or instead a page of Google search results comprised of links and their descriptions.

  • Interactive usage allows the user to continue making new queries by dynamically executing new program flags and/or queries. Entering h or help will list all possible prompt commands.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    1. Guido van Rossum - Official Site
    2. Images of python guido
    3. Guido van Rossum - Wikipedia, the free encyclopedia
    4. Guido van Rossum (@gvanrossum) | Twitter
    5. Guido van Rossum Wants to Bring Type Annotations to Python
    6. The Python Tutorial — Python 2.7.10 documentation
    7. Python (programming language) - Wikipedia, the free ...
    8. Van Rossum: Python is not too slow | InfoWorld
    + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    : d 1
    Guido's Personal Home Page     Guido van Rossum - Personal Home Page  "Gawky and proud of it."
    Dutch spelling rules dictate that when used in combination with myfirst name, "van" is not capitalized: "Guido van Rossum".
    But when mylast name is used alone to refer to me, it is capitalized, forexample: "As usual, Van Rossum was right."
    More Hyperlinks   Here's a collection of  essays  relating to Pythonthat I've written, including the foreword I wrote for Mark Lutz' book"Programming Python".
    The Audio File Formats FAQ  I was the original creator and maintainer of the Audio File FormatsFAQ.  It is now maintained by Chris Bagwellat .
    [Press Enter to continue..]
  • To choose multiple links at once, a range may be specified by separating the start and end range with a dash. Leaving one end of the range blank will choose all links until the other end of that range. For example, given 10 links, entering 5- would effectively be the same as entering 5-10.

  • Requests cache is enabled by default to cache webpages, it can be disabled by setting the environment variable CLIQ_DISABLE_CACHE.

  • Using the bookmark flag with no arguments will list all current bookmarks in .cliqrc, naturally ordered by time of entry. Entering help with the flag will list all possible commands including open, add, remove, tag/untag (for aliasing), describe, and move. Bookmarks like other flags may be entered during runtime in the link prompt.

  • Additional arguments may be appended to bookmarks while opening them. These are interpreted as any non-integer arguments which are not found in any bookmarks (URLs or tags).

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cliquery-1.10.1.tar.gz (30.9 kB view hashes)

Uploaded Source

Built Distribution

cliquery-1.10.1-py3-none-any.whl (25.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page