coffee-cli 0.1.0

A polished Python terminal UI for coffee-themed developer workflows.

Coffee CLI

Coffee CLI is a Python terminal UI application for developers who want a polished, installable coffee command with personality. The app is built as a modern Python package and is intended to grow into a showcase project for terminal UX, testing, CI/CD, and professional packaging.

Project goals

• Launch with coffee after installation.
• Use Textual for a polished TUI.
• Keep the codebase educational and production-leaning.
• Validate every change with tests, linting, and CI.

Local environment

This project is being developed inside:

• project root: /home/redsteam/Desktop/bear/ML/coffee-for-devs
• virtual environment: /home/redsteam/Desktop/bear/ML/MLprojs

Activate the environment:

source /home/redsteam/Desktop/bear/ML/MLprojs/bin/activate

First-time setup

Install the project and developer tools into the virtual environment:

python -m pip install -e ".[dev]"

Run the quality checks:

ruff check .
pytest
python -m build

Start the app:

coffee

Install from a wheel

Build the package:

python -m build

Install the generated wheel into a fresh environment:

python -m pip install dist/coffee_cli-0.1.0-py3-none-any.whl
coffee

This is the local release-candidate check before publishing to PyPI.

Release publishing

Publishing is handled by the manual GitHub Actions workflow in .github/workflows/publish.yml. Use target=testpypi first, verify the package, then publish to PyPI from a version tag such as v0.1.0.

Current scope

Coffee CLI currently includes:

• modern pyproject.toml packaging
• src/ layout
• coffee console script entry point
• first Textual app skeleton with animated ASCII steam
• order flow, brewing flow, personal favorites, journal, and statistics
• tested package structure
• GitHub Actions CI workflow

See docs/roadmap.md for the planned sprint breakdown, docs/milestones.md for runnable milestones, docs/release-checklist.md for release steps, and CONTRIBUTING.md for the Git workflow.