wiCLIpedia

This is a minimalist command line interface (CLI) program to fetch and display data from Wikipedia.

In an era where Artificial Intelligence answers everything and large language models shape our knowledge, this program is a small tribute to Wikipedia, the silent, human-curated backbone that feeds those very models. Never forget the source.

Features

• Fetches and displays article summaries and table of contents
• Navigates article sections interactively
• Jumps to related pages linked within the article sections
• Handles redirects and disambiguation pages automatically
• Supports multiple Wikipedia languages
• Caches responses locally to minimize API calls
• ANSI colors and styles for enhanced readability (can be disabled)

Installation

pip install wiclipedia

Usage

wicli "Blade Runner"

If no page title is provided, the program will prompt you to enter one interactively.

You will be interactively prompted to navigate through the article summary sections.
To navigate, use the section numbers shown in the table of contents.

If the query matches a disambiguation page, you will be prompted to select the intended article from a list of options.

While reading an article, related pages found in list items (e.g. a "See also" see) are listed at the end of each section. Use j1, j2, etc. to jump directly to one of them.

By default, it fetches the English Wikipedia. To specify a different language, use the -l or --lang option:

wicli "La classe operaia va in paradiso" --lang it

Available commands during navigation:

• :b — Go back to the start prompt
• :q — Exit the program
• :m — Show the table of contents menu (only available when navigating sections)

Options

Cache

Responses are cached locally for 72 hours to reduce API calls.
The cache is stored in ~/.cache/wiclipedia/.
Use --no-cache to bypass it for a session, or --purge to clear it entirely.

Display

ANSI colors and styles are enabled by default.
Set the NO_COLOR environment variable to disable them (see no-color.org).

API Respect and Fair Use Disclaimer

wiCLIpedia interfaces directly with the official Wikipedia PHP/MediaWiki APIs without using any third-party scraping libraries.
Please use this program responsibly. If you need to perform massive automated data extraction, use official database dumps instead of hammering the live API.

wiCLIpedia caches responses locally for 72 hours by default to minimize API load. Check the Cache section for details.

More information about the MediaWiki API and usage guidelines:

• API Documentation
• API Etiquette

License

This program is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
See the LICENSE file for details.

Changelog

See CHANGES.md for release notes.