A git wrapper for game-style save/load points.
npm install @a4ayush/gitquest

A friendly, game-like CLI for everyday version control checkpoints.
---
GitQuest turns common Git workflows into a calm, guided experience. Think quick save points, safe discards, and an interactive history browser — all wrapped in a chill UX.
Requires Node.js v18 or higher.
``bash`
npm install -g @a4ayush/gitquest
Then, run gq in any git repository to launch the interactive experience:
`bash`
gq
`bashgqfrom the project root
npm install
npm linknow you can use
locally`
gq
All examples use the gq shorthand alias, but using the full gitquest command works just as well. They are completely interchangeable.
Commits all changes, pushes to origin, and shows your save stats and streaks.
`bash`
gq save "Your commit message"

Resets the working tree and cleans untracked files. When not forced, it prompts for confirmation.
`bash`
gq discard
gq discard --force

Pulls remote changes and reports whether you’re up to date.
`bash`
gq sync

Prints the usage and basic help message.
`bash`
gq help
⚠️ Warning: Commands like gq discard --force or branch resets in history are irreversible. Always make sure you’ve committed any work you want to keep.
- gq discard --force is a destructive and irreversible action. Use it with caution.reset
- The action in the history browser will overwrite the remote history. It requires explicit confirmation and should only be used when you fully understand the consequences.
If you encounter any issues, please open an issue on GitHub:
https://github.com/a4ayush/gitquest/issues
When reporting, please include:
- Your Node.js and npm versions.
- The minimal steps to reproduce the bug.
- The state of your repository if relevant (e.g., clean, dirty, behind remote).
- License: MIT © Ayush Saxena (See the LICENSE file for details)
- Author: Ayush Saxena
- Contributors: Orion (AI collaborator)
- Powered by: @clack/prompts, chalk, and simple-git`.
---
“May your branches stay clean and your streaks stay alive.”