Happy New Year!

It has been 203 days since the release of git gud, and Im incredibly grateful for how many people have played and enjoyed the game. Hopefully, everyone has picked up a new Git command or two along the way as well.

This update is a big one, the largest so far. One of the most important additions is the new Content Pack system, which is the plan going forward for continued development. Content packs will introduce new sets of challenges built around themed, real-worldstyle scenarios. Each pack will be low cost (around a dollar or two) and will go on sale whenever the base game does. Its important to me to keep git gud accessible while still being able to justify the time required to add meaningful new content and improvements. The first content pack will be releasing shortly alongside an introductory sale.

You may notice that this update includes a lot of changes. While some of that work was driven by the first content pack, I also added 246 new unit and integration tests. This surfaced a number of edge cases and areas that needed improvement, and it should significantly reduce the chance of regressions, particularly cases where previously valid challenge solutions would break after a major update.

git gud now includes support for git-filter-repo. I originally avoided this since it isnt part of core Git, but Ive listened to the community feedback encouraging its use over [c]git filter-branch[/c]. Existing challenges will continue to accept either tool as valid solutions, but an upcoming content pack introduces scenarios where company policy explicitly forbids [c]filter-branch[/c].

Ive also made another pass at tab completion. This iteration should be a noticeable improvement and closer to real-world behavior across common terminal environments.

Finally, macOS support is now included. This has been available in the development branch for about a week with no reported issues so far. If any problems do come up, please report them in the Steam Discussions bug reporting forum so they can be addressed quickly.

As a small but important note: going forward, each release will be archived as a beta branch. If you run into issues with [c]1.5.0[/c], youll be able to revert to [c]1.4.2[/c] while waiting for fixes. This was requested by a university that uses git gud in coursework and needs tighter control over version upgrades.

Thanks again to everyone for the continued support,\nSky

[u]Changelog 1.5.0[/u]

New Features

- Content Pack system added

- Initial implementation of [c]git filter-repo[/c]

- Added [c]--create-branch[/c] flag to [c]git worktree[/c]

- Added [c]echo[/c] game command

- Significant improvements to the Tab Complete functionality

- Added support for MacOS

Git Simulation Improvements

- Improved [c]git rebase[/c] emulation for closer real-world behavior

- Especially around rebase todo ordering

- Improved [c]git filter-branch[/c] emulation accuracy

- Improved [c]git bisect[/c] to reduce redundant simulation guidance

- Removed unsafe substrings in both rebase and bisect simulations

- Merge emulation is now graph-based:

- Introduced a new [c]CommitGraph[/c] utility used across the simulation

- Merge commits are now true multi-parent commits (no-ff merges link both histories)

- Merge validation now checks commit ancestry and reachability instead of commit message text

Validator Updates

- Improved validators for Bisect, Rebase, Branch, Commit, File, and Stash

- Improved file validator for restore related edge cases

- Revised all [c]git clean[/c] validators

- Revised [c]CommandNotUsed[/c]:

- Now fully blocks execution of disallowed commands for a challenge

- Examples: [c]git add[/c] in Challenge 4, [c]git pull[/c] in Challenge 71

- Fixed branch validator supporting checkout-based creation but not [c]git switch[/c] (Challenge 81 notably)

- Fixed filter-branch validator not accepting [c]--index-filter[/c]

- Fixed clone validator not accepting [c]--mirror[/c]

Bug Fixes

- Fixed header displaying [c]Completed: {diff}[/c] instead of [c]Difficulty: {diff}[/c]

- Fixed [c]git checkout[/c] saying switched to branch when already there

- Fixed edge case where Back from a challenge set prompted a progress reset

- Fixed [c]git bisect good/bad[/c] marking the next commit instead of the current one

- Fixed restore revision specifier handling

- Fixed stash save/push not supporting positional message arguments

- Fixed `git log` validator [c]--oneline[/c] flag placement

- Fixed inconsistencies in [c]git log --author[/c] parsing

- Fixed [c]git rebase [/c] targeting support

- Fixed [c]git restore --staged[/c] edge cases

Hey everyone,

v1.5.0 will be releasing in a few days, and its a major update. This release includes a large number of improvements, fixes, and new functionality. One of the biggest highlights is initial macOS support.

I dont currently have reliable access to a macOS testing environment, so community testing would be incredibly helpful. If youre on macOS and willing to test the update, your feedback would be greatly appreciated.

The v1.5.0 branch is available now via Steam Beta. To access it, right-click the game in your library, select Properties, then Betas, and opt into the v1.5.0 branch. This is available to all players, including those on macOS.

[img src=\"https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/clans/45597201/87a3b0aee313ab00d498dd6a2d5f3e8a5d04f533.png\"][/img]

Full changelogs will be posted closer to the official release.\n

Please provide any feedback or bug reports for this beta build in either:\n\nSteam Discussions

\nDiscord

Thanks again for all the support!

[u]Changelog 1.4.2[/u]

• Fixed branch --move targeting (thanks Mellow Geek)

  [/*]

Hey everyone,

I was at a conference recently showcasing Fishagon\'s games including git gud (and the newly released https://store.steampowered.com/app/3819510/DexSweeper/\"" style="color:#bb86fc;text-decoration:none;">DexSweeper ) and some of the suggestions from players prompted a small quality of life update that I think bring a large impact with minimal changes.

I\'m not sure what the next major update for git gud will be, but I have some long term plans for updates in the next year. If anyone has thoughts of what they would like to see feel free to reach out on the Steam Discussions or on the Discord!\n\nThanks again for playing everyone.

[u]Changelog 1.4.1[/u]

• Revised the hints for challenge 4

  [/*]

• Hint quantity now displays in the response

  [/*]

• Fixed handling of single quote characters

  [/*]

Hey everyone,

I\'ve been working on refactoring the game for awhile to support localization in the menus, intro to git, and challenges. It was a pretty significant refactor and I also had to coordinate with a localization team that I was able to source for the first 6 additional languages.

[u]Changelog 1.4.0[/u]

• Added Localizations

  [list]

• German

  [/*]

• French

  [/*]

• Russian

  [/*]

• Ukrainian

  [/*]

• Polish

  [/*]

• Brazilian Portuguese

  [/*]

As I do not speak any of the languages, I have not been able to verify significantly if they properly convey the purpose of the original meanings in the game.

And if you find any issues you can report them in the following thread on Steam Discussions

Localization Feedback & Reports

And if you would like to actually help contribute to the localization of these 6 languages or add additional languages to the game; I have open sourced the localization files and made a guide on how to contribute that can also be found below.

Localization Github

\nAnd lastly, it would mean a lot if everyone could check out Fishagon\'s next upcoming game DexSweeper. It\'s a dexterity minesweeper variant releasing on November 4th. You can play the demo now and it will be in the upcoming October Next Fest as well. Perhaps give it a wishlist?\n\n[dynamiclink href=\"https://store.steampowered.com/app/3819510/DexSweeper/\"][/dynamiclink]Thanks again to everyone who has played git gud. I plan on supporting this game as long as people are enjoying it! Let me know what you would like to see in the next update.

Hey everyone,

I\'ve been working on refactoring the game for awhile to support localization in the menus, intro to git, and challenges. It was a pretty significant refactor and I also had to coordinate with a localization team that I was able to source for the first four languages.

As I do not speak any of the languages, I have not been able to verify significantly if they properly convey the purpose of the original meanings in the game. Hopefully some of you will be happy to help us test this content before it goes live on Monday. \n\nif you would like to join the beta and switch over to the dev-branch it can be found in the game properties like in the image below.

[img src=\"https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/clans/45597201/87a3b0aee313ab00d498dd6a2d5f3e8a5d04f533.png\"][/img]

And if you find any issues you can report them in the following thread on Steam Discussions

Localization Feedback & Reports

And if you would like to actually help contribute to the localization of these 4 languages or add additional languages to the game; I have open sourced the localization files and made a guide on how to contribute that can also be found below.

Localization Github

[u]Changelog 1.4.0 Beta[/u]

• Added French Localization

  [/*]

• Added German Localization

  [/*]

• Added Russian Localization

  [/*]

• Added Ukrainian Localization

  [/*]

A lot of feedback since release could be categorized under \"Quality of Life\" features that were missing at release. Most notably people have been bringing up the ability to tab complete things like file names and commands. Happy to announce git gud now supports that and much more!

And now that we have a nice suite of quality of life features out of the way; we are on to the next major update: Sandbox & Steam Workshop Support. Soon the community will be able to make their own challenges and share them!\n\nOnce again, I want to thank everyone who has played git gud!

[u]Changelog 1.3.0[/u]

• Word Wrapping

  [/*]

• Tab Auto-Complete

  [/*]

• Command Chaining (&& and ; support)

  [/*]

• Custom History Handling

  [/*]

• Massive Refactor to Command Flags

  [/*]

• Updated the \"git help\" Command

  [/*]

• Fixed validation for challenge 26 (thanks Epsilon Theta)

  [/*]

Hey everyone! \n\nThe \"Quality of Life\" update was a rather large refactor of a lot of parts of git gud, however it adds a lot of features that were being requested such as tab completion, word wrapping, command chaining, and more.

However, due to the nature of the update potentially causing issues I am currently putting it in the [u]dev-branch[/u] that any of you can join now.

[img src=\"https://cdn.cloudflare.steamstatic.com/steamcommunity/public/images/clans/45597201/87a3b0aee313ab00d498dd6a2d5f3e8a5d04f533.png\"][/img]

Just right click on git gud in the library and click Properties. Then go to Betas and you\'ll see a dropdown with the [u]dev-branch[/u] available.

\nChanges in Beta:\n- Word Wrapping

- Tab Auto-Complete

- Massive Refactor to Command Flags

- Custom History Handling

- Updated the \"git help\" Command

- Fixed validation for challenge 26 (thanks Epsilon Theta)\n

Report any bugs while testing to the following Steam Discussion thread https://steamcommunity.com/app/1490570/discussions/0/596280128149944187/

[u]Changelog - 1.2.2[/u]

- Adjusted hints for Challenge 98

- Relaxed Rev List validator (thanks fortunexxxx & revenge)

- Added support for many syntaxes to LogValidators (thanks Nomiswelt)

Hey guys,

This is just a very small hotfix. The Commit Ancestory Notation update yesterday caused some issues with a few validators in the RebaseValidator set. dminsky pointed this out in discord and I got to work refactoring the rebase validators to be a bit more flexible to different input scenarios.

These are some of the most complicated validators in the project, so hopefully we have now caught all the scenarios around them.

Sorry about that everyone!

[u]Changelog - 1.2.1[/u]

- Fix for RebaseValidators (thanks dminsky)

When I originally started git gud I had no idea how many people would play it and have little to no experience. So I've added a new, short, introduction to Git called "Intro to Git" that can be played in both the full game and the demo version!

Hopefully this new mode will give you enough information on how to proceed going into the Challenge Mode!

[u]Changelog 1.2.0[/u]

- Intro to Git Mode Added

- Refactor for Commit Ancestor Notation

- Initial implementation for Commit Parent Notation

Another quick update of fixes for the bugs reported on the discussions page and the Discord .

And just and update on bigger changes, the next addition to the game will likely be an "Introduction to Git" mode. There have been more players than I anticipated interested in the game that don't have much of a background in Git.

These will be simple challenges that inform the player about the basic concepts of Git, Repositories, and how to use the official documentation & help commands. Hopefully these will act as a "tutorial" that will lead you into playing the featured Challenge Mode and reduce the reliance on using hints. [b][u]

Changelog 1.1.1[/u][/b]

- Adjusted hints for challenge 4

- Added HEAD reference syntax to Push command (thanks adamsogm)

- Added support for branch --delete --force flag combination (thanks jazck & Cyril)

- Fixed reset detection with commits squashed validator (thanks adamsogm)

- Fixed syntax handling in Stash validators (thanks Pandasaurus_R)

- Fixed stash default behaviour with flags (thanks Pandasaurus_R)

- Fixed shorthand bisect start (thanks jazck & Pandasaurus_R)

- Fixed --amend with no other flag not opening editor (thanks adamsogm)

- Relaxed the validator requirements for challenge 31 (thanks adamsogm & jazck)

[u]Changelog - 1.1.0[/u]

- Overhauled the menus

- Overhauled display settings

- Fixed a bug where restarting wouldn't resume to the next challenge

- Fixed log --graph output styling

- Fixed bug with restore with no source provided

- Changed validators on Challenge 26

[b][i]git add GitGud_Linux
git commit -m "Added Linux Support"
git push
git switch main
git merge feature-linuxSupport[/i][/b]

git gud is out now.

The day has come git gud 1.0 is now live and available for purchase! You can finally play through the full game, all 100 levels of branching, merging, stashing, rebasing, and more.

Im incredibly excited to share this with everyone, and I cant thank you enough for the amazing feedback during the Steam Next Fest demo. Your bug reports, feature requests, and encouragement helped shape this final release and the Git simulation is better for it.

With the launch of 1.0, git gud now includes native Linux support, running on a .NET version fully compatible with Linux. No Proton required.

Huge thanks to jazck in the community Discord for helping test early Linux builds before I had a proper VM set up!

Looking to the Future

The demo was played by thousands, and the response blew me away. Based on all the support and feedback, heres a rough roadmap of whats next (subject to change):

• Custom terminal/editor preferences on Linux

  [/*]

• New game modes: Command Trials, Real-World Scenarios, and more

  [/*]

• Git engine improvements for near-perfect command parity

  [/*]

• Steam Cloud support

  [/*]

• Sandbox mode and Steam Workshop for user-created challenges

  [/*]

• and more!

  [/*]

I hope we can continue to improve and build on this game for a long time to come and make it the best Git simulation game and learning tool we can.

How can we support?

If you like the project (or even just like the idea), heres how you can help:

• Tell a friend who's learning Git (or just obsessed with it)

  [/*]

• Post about the game on social media

  [/*]

• Wishlist or leave a review (even the critical ones help!)

  [/*]

• Join the discussions or our Discord community
  Join the Discord

  Whether youre a student, a seasoned dev, or just a terminal nerd; I hope git gud helps make Git just a little more fun.

  [/*]

Hey everyone,

I have done a bunch of bug fixes and starting to ramp up to the release of 1.0 tomorrow. I'm trying to add in a lot of the foundation for features I have planned post-launch. I've resolved all the bug reports we've had so far now. Thank you all so much for reporting those in the Steam Discussions for me to fix!

I can't wait for everyone to play the full game tomorrow and I hope you'll attempt to 100% the achievements as well; it won't be easy.

Note to Linux users: I know a lot of you are playing on linux via Proton's emulation. A user has recently shown me what that looks like on the discord. There are challenges later in the game that won't be solvable with emulation unfortunately (I don't think, I could be wrong).

I am going to be updating to a version of .Net that will allow me to build this for Windows and Linux, but that will require more testing. If you're willing to help with that please do join the discord.

Join the Discord

[u] Changelog - 0.4.0[/u]

- Overhauled the Save

- Added Steamworks

- Added Achievements (will be in full release)

- Refactored Status command

- Added back the git help {command} feature

- Fixed validators for challenge 8 (thanks Pwnage Block)

- Multiple status bugs fixed (thanks Xudmud & 4LT)

- Fixed bug in the MergeConflictResolved validator (thanks Myndale)

- Fixed bug with branch deletion (thanks jazck)

A few people have requested Command Prompt / PowerShell / Linux commands for things like creating files, listing files, editing files, etc. So I've started to add em!

As well I've begun refactoring a lot of the commands in the game to not just include the solutions I've thought of for the challenges, but to have complete parity to the commands in Git. In this version of the demo you'll notice a lot more commands and flags exist now (rev list, merge base, clean, bisect, cherry pick, and more) as well additional flags on a lot of the basic commands you had already.

My hope is that soon after release I can make a "sandbox" environment. With it players will be able to build repositories and use them for their own custom challenges that will be used with Steam Workshop. The first step to that though will be full parity with Git & a range of validators for you all to use.

And once again, I just want to say thank you to everyone who has played, wishlist, or provided feedback on the game. I appreciate you all taking time to try it! I hope everyone enjoys the full game when it comes out on the 17th.

[u] Changelog - 0.3.0[/u]

- Refactored multiple commands for fuller Git parity

- Added more git commands for full release

- Added Command Prompt Command (start)

- Added PowerShell Command (new-item, get-content, dir, invoke-item)

- Added Linux Command (touch, cat, ls, xdg-open)

- Added MacOS Command (open)

- Reflog Command & Reflog Entry Tracking

- Fixed git stash handling short commitIds (thanks nightshade nocturne)

It's another short update based on community feedback. I've made some minor adjustments for clarity on hints. But the major thing is adding switch and all the possible flags for branch.

Originally I was going to wait until release to update with the switch command but based on feedback from you guys I put in a few extra hours of testing to feel confident releasing it now during Next Fest.

[u] Changelog - 0.2.0[/u]

- Added the switch command

- Added every branch flag, this might have bugs as there is a lot new (thanks manfart2021)

- Adjusted challenge 11 validator for new commands

- Adjusted challenge 4 hints for clarity

Hey everyone, I firstly just want to say thanks so much for playing git gud! Seeing so many people have downloaded and tried the game is fantastic to see as I didn't expect the game to appeal to many people as it is very niche (or so I thought).

And a huge special thank you to the users below who reported bugs that I was able to quickly get fixed for everyone.

I will note multiple people have reached out to me about Git 2.23 commands, mainly switch, missing from the simulation. This fault entirely lies on me. I was unaware how well adopted the 2.23 changes were and personally myself have always been taught and used the traditional checkout commands even though they are very overloaded.

Git 2.23 features such as switch and restore will be coming soon and will certainly be included by the time the game releases on the 17th.

- Demo now includes the full Git simulation and is only missing the levels

- Fixed bug with hints showing out of order (thanks Darquesse27)

- Fixed branch --no-merged being called --unmerged (thanks Alfonso Matador)

- Fixed init not accepting a directory name (thanks RIMA)

Steam June Next Fest!

The wait is over git gud is now live with a playable demo as part of Steams June Next Fest!

Im incredibly excited for you to finally get your hands on it. Whether you're brand new to Git or just looking to sharpen your command line skills, git gud is designed to make learning Git feel like a gamebecause it is one!

Now, lets be real: Git isnt exactly known for being beginner-friendly or fun. But thats exactly why I made this game. git gud gives you hands-on experience with a fully simulated Git environment, teaching you skills that go far beyond what GUI tools can offer.

A quick heads-up: Git is massive, with countless commands and flags. There may be challenges with multiple valid solutions, or edge cases where your input isnt recognizedyet. If something should work but doesnt, please hop over to the Bugs & Solutions forum on the Steam Discussions page and let me know!

I've worked hard to make git gud as close to real Git as possibleeven simulating complex features like interactive rebasing. It's a passion project, and your feedback will help make it even better for full release.

Thanks so much for checking out git gud! I hope you enjoy the demo, and Ill see you again when the full game launches on June 17th.
Also join our Discord!