firecow/gitlab-ci-local — reverse-engineered prompt

Build me a command line tool like gitlab ci local that lets me run a project’s GitLab pipeline on my own machine instead of pushing commits just to test the config.

It should read a normal .gitlab-ci.yml, execute jobs locally with either the shell or Docker, and make it easy to run a whole pipeline or just a specific job. I also want nice quality of life stuff, like being able to list which jobs would run before actually running them, support for default options through environment variables or a local config file, optional dotenv loading, quieter or timestamped logs, and simple shell completion. It should handle common pipeline behavior like stages, needs, includes, variables, and artifacts well enough to feel useful in real projects.

Please make it work as a polished CLI app with examples, tests, and clear docs for Linux, Mac, and Windows Git Bash use. If anything is unclear, look up current GitLab CI behavior and local runner expectations online and make sensible choices.