wut-dictionary-cli 0.1.2

A modern CLI dictionary with pronunciation and bookmarking

Wut?

Wut? is a command-line dictionary for quick lookups, pronunciation, and personal word bookmarks.

Originally built as my CS50P final project, this repo carries a lot of my early development memories.

The name came from those moments while reading where you hit a word and think, "wut?"

Why This Exists

While reading articles, documentation, or even chats, you often run into words you half-know or do not know at all.

Most of the time, the flow is the same: switch tabs, open a search engine or dictionary, type the word, then come back. Wut? exists to reduce that context switching. You stay in the terminal, get the meaning fast, hear pronunciation when needed, and bookmark words you want to revisit later.

What It Does

• Looks up definitions, examples, synonyms, and antonyms
• Plays pronunciation for words
• Saves and manages bookmarks locally

Installation

From PyPI (Recommended)

pipx install wut-dictionary-cli

Then run:

wut --help

If pipx is not installed:

python -m pip install --user pipx
python -m pipx ensurepath

From Source

git clone https://github.com/devadathanmb/wut.git
cd wut
pipx install . --force

Usage

Quick Lookup

# Simplest form
wut hello

# Lookup + pronunciation
wut hello -p

# Lookup + bookmark
wut hello -b

# Interactive prompts
wut hello -i

# Explicit lookup command
wut lookup hello -p -b

Bookmarks

# Add
wut bookmark add hello

# List
wut bookmark list

# List with search
wut bookmark list -s hel

# Show one
wut bookmark show hello

# Delete one
wut bookmark delete hello

# Clear all
wut bookmark clear

Pronunciation

# Normal speed
wut pronounce hello

# Slow speed
wut pronounce hello -s

Info

# Database path + bookmark count
wut info

Development

This project uses uv for dependency and environment management.

1. Install prerequisites.

python --version
uv --version

2. Clone the repository.

git clone https://github.com/devadathanmb/wut.git
cd wut

3. Create the local dev environment and install dependencies.

uv sync --extra dev

4. Run the CLI locally.

uv run wut --help
uv run wut hello

5. Run tests.

uv run pytest tests/ -v

6. Run lint and type checks.

uv run ruff check src/ tests/
uv run mypy src/ tests/
uv run --with pyright pyright

7. Optional: activate .venv if you prefer direct commands.

source .venv/bin/activate
pytest tests/ -v
ruff check src/ tests/

Credits

• Free Dictionary API for the dictionary data used by this project.

License

GNU Affero General Public License v3.0 (AGPL-3.0)

Known Limitations

Dictionary results depend on the Free Dictionary API. If a word is missing there, or the service is temporarily down, Wut? will fail to fetch results.