I've started working on a project called gg and I would love if you contributed or used it!

What is it?

It's a collection of games you can play from the CLI. They aren't overly sophisticated, mostly minimalist games like 2048, hangman, connect 4, and more.

There are a mix of two player games and single-player games.

Why use it?

I can really only speak for myself, but there have been a ton of times when I was bored and had nothing to do, but also no access to full-on games like Trackmania.

So I made this! It's something to do while you're bored, and if you want, you can also gain coding experience by contributing to it, opening bug reports, and more. All contributions are appreciated :)

Technical stuff

I decided to use Go because I'm familiar with it, it's easy to learn and read, it's popular, and it's fast. Being a compiled, cross-compatible language doesn't hurt, either.

Installation

If you want to test it right now, you can!

If you have Go installed, you can run one of these commands:

$ go run github.com/Kaamkiya/gg@latest # To run without installing
$ go install github.com/Kaamkiya/gg@latest # To install

If not, no worries! Head over to the releases page and pick the one for your platform.

Usage

If you used go run, it should start automatically. If not, run the executable you downloaded, or just type gg if you used go install.

Pick something from the list of options and play! You can even invite a friend to play with you.

Enjoy!

Contributing

All contributions are welcome, from bug reports to README updates to entirely new games.

If you'd like, feel free to contribute!

Roadmap

I don't have a perfectly clear vision of the project's future, but I think I'll keep updating it and adding to it for a very long time.

Conclusion

That's it from me for now!

If you've got any questions, comments, or anything else, feel free to comment. I'll reply when I can :)

Have a good day, folks!