{"_id":"@a4ayush/gitquest","_rev":"2-b7e0f5ea273b34199fde0eac70f92f92","name":"@a4ayush/gitquest","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@a4ayush/gitquest","version":"1.0.0","keywords":["git","cli","gamification","git-tool","version-control","developer-tool","command-line","interactive","workflow","save-points","streak"],"author":{"name":"Ayush Saxena"},"license":"MIT","_id":"@a4ayush/gitquest@1.0.0","maintainers":[{"name":"a4ayush","email":"a4ayush@gmail.com"}],"contributors":[{"url":"https://orionaix.com/","name":"Orion"}],"homepage":"https://github.com/a4ayush/gitquest#readme","bugs":{"url":"https://github.com/a4ayush/gitquest/issues"},"bin":{"gq":"bin/index.js","gitquest":"bin/index.js"},"dist":{"shasum":"d45fca72afcb45e5dde7f94586a31d80673e5f66","tarball":"https://registry.npmjs.org/@a4ayush/gitquest/-/gitquest-1.0.0.tgz","fileCount":18,"integrity":"sha512-OPJ+RkW8iY7mvOa5n4yWEpnqGNC6/Bsg8uDMQ2QsGnj6geYk6XhJEweG8M6wTV8Z2eWq/M0NptlZbNOR8ThXog==","signatures":[{"sig":"MEQCIC9hyJ2UcEw7FedR0PXcj94ZnnQQhY+Bq5HlAmhJhL9JAiAueBzJk8L/xjFrCel4raBYNgcmXbGnPDqM4I51PAoT8A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":266883},"main":"src/index.js","type":"module","engines":{"node":">=18"},"gitHead":"c673cf3d92f95970dfe7ae7f139e03331d66f749","scripts":{"test":"echo \"Error: no test specified\" && exit 1","prepare":"chmod +x bin/index.js"},"_npmUser":{"name":"a4ayush","email":"a4ayush@gmail.com"},"repository":{"url":"git+https://github.com/a4ayush/gitquest.git","type":"git"},"_npmVersion":"11.1.0","description":"A git wrapper for game-style save/load points.","directories":{},"_nodeVersion":"22.13.0","dependencies":{"chalk":"^5.6.2","simple-git":"^3.28.0","@clack/prompts":"^0.11.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/gitquest_1.0.0_1760699057770_0.6932711517692511","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@a4ayush/gitquest","version":"1.0.1","description":"A git wrapper for game-style save/load points.","author":{"name":"Ayush Saxena"},"contributors":[{"name":"Orion","url":"https://orionaix.com/"}],"homepage":"https://github.com/a4ayush/gitquest#readme","repository":{"type":"git","url":"git+https://github.com/a4ayush/gitquest.git"},"bugs":{"url":"https://github.com/a4ayush/gitquest/issues"},"main":"src/index.js","type":"module","bin":{"gitquest":"bin/index.js","gq":"bin/index.js"},"engines":{"node":">=18"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","prepare":"chmod +x bin/index.js"},"keywords":["git","cli","gamification","git-tool","version-control","developer-tool","command-line","interactive","workflow","save-points","streak"],"license":"MIT","dependencies":{"@clack/prompts":"^0.11.0","chalk":"^5.6.2","simple-git":"^3.28.0"},"_id":"@a4ayush/gitquest@1.0.1","gitHead":"fd579dce7114a556c44ee398f0b8dd053aaabaef","_nodeVersion":"22.13.0","_npmVersion":"11.1.0","dist":{"integrity":"sha512-wSqmxzuuWGePpa9rM+Qs1117pmy9lFCnvRIRkaIrdbLOmvlmu/scb4+uGc1/7HLrqtMeQtM4HYc+C7OTtow6VA==","shasum":"335dd1a3234e22dc4ff1b2a62b663f990ded8780","tarball":"https://registry.npmjs.org/@a4ayush/gitquest/-/gitquest-1.0.1.tgz","fileCount":18,"unpackedSize":266928,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDZfSVPk7pWvknn+9M8Vc2RwC9ICZP6QIfLrku6dSL7AQIhAKy17cMrUxnioJbW3ebvDL8JfuYBkxiPs22bHkm01nda"}]},"_npmUser":{"name":"a4ayush","email":"a4ayush@gmail.com"},"directories":{},"maintainers":[{"name":"a4ayush","email":"a4ayush@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gitquest_1.0.1_1760699936146_0.9025449995912003"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-17T11:04:17.634Z","modified":"2025-10-17T11:18:56.781Z","1.0.0":"2025-10-17T11:04:18.035Z","1.0.1":"2025-10-17T11:18:56.389Z"},"bugs":{"url":"https://github.com/a4ayush/gitquest/issues"},"author":{"name":"Ayush Saxena"},"license":"MIT","homepage":"https://github.com/a4ayush/gitquest#readme","keywords":["git","cli","gamification","git-tool","version-control","developer-tool","command-line","interactive","workflow","save-points","streak"],"repository":{"type":"git","url":"git+https://github.com/a4ayush/gitquest.git"},"description":"A git wrapper for game-style save/load points.","contributors":[{"name":"Orion","url":"https://orionaix.com/"}],"maintainers":[{"name":"a4ayush","email":"a4ayush@gmail.com"}],"readme":"# GitQuest\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@a4ayush/gitquest\">\n    <img src=\"https://img.shields.io/npm/v/@a4ayush/gitquest.svg\" alt=\"npm version\">\n  </a>\n  <a href=\"https://github.com/a4ayush/gitquest/blob/main/LICENSE\">\n    <img src=\"https://img.shields.io/npm/l/@a4ayush/gitquest.svg\" alt=\"license\">\n  </a>\n  <a href=\"https://nodejs.org/\">\n    <img src=\"https://img.shields.io/node/v/@a4ayush/gitquest.svg\" alt=\"node version\">\n  </a>\n</p>\n\n<p align=\"center\">\n  <img src=\"img/gq-header.png\" alt=\"GitQuest header showing terminal UI\">\n</p>\n\n<p align=\"center\">\n  <em>A friendly, game-like CLI for everyday version control checkpoints.</em>\n</p>\n\n---\n\nGitQuest 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.\n\n### 💡 Why GitQuest?\nGitQuest turns version control into a calm, intentional habit.  \nInstead of memorizing Git commands, you focus on flow — saving progress like checkpoints, syncing safely, and staying mindful of your creative rhythm.\n\n## 📥 Installation and Quickstart\n\nRequires **Node.js v18 or higher**.\n\n### - Install globally from npm:\n\n```bash\nnpm install -g @a4ayush/gitquest\n```\n\nThen, run `gq` in any git repository to launch the interactive experience:\n\n```bash\ngq\n```\n\n### - For local development and testing:\n\n```bash\n# from the project root\nnpm install\nnpm link\n# now you can use `gq` locally\ngq\n```\n\n## 💥 One-Shot Commands\n\nAll examples use the `gq` shorthand alias, but using the full `gitquest` command works just as well. They are completely interchangeable.\n\n### `gq save`\n\nCommits all changes, pushes to origin, and shows your save stats and streaks.\n\n```bash\ngq save \"Your commit message\"\n```\n\n<img src=\"img/gq-save.png\" alt=\"GitQuest Save\" width=\"400\">\n\n### `gq discard`\n\nResets the working tree and cleans untracked files. When not forced, it prompts for confirmation.\n\n```bash\ngq discard\ngq discard --force\n```\n\n<img src=\"img/gq-discard.png\" alt=\"GitQuest Discard\" width=\"400\">\n\n### `gq sync`\n\nPulls remote changes and reports whether you’re up to date.\n\n```bash\ngq sync\n```\n\n<img src=\"img/gq-sync.png\" alt=\"GitQuest Sync\" width=\"400\">\n\n### `gq help`\n\nPrints the usage and basic help message.\n\n```bash\ngq help\n```\n\n## ⚠️ Safety notes\n\n⚠️ **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.\n\n- `gq discard --force` is a destructive and irreversible action. Use it with caution.\n- The `reset` 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.\n\n## 🐞 Reporting bugs\n\nIf you encounter any issues, please open an issue on GitHub:\n[https://github.com/a4ayush/gitquest/issues](https://github.com/a4ayush/gitquest/issues)\n\nWhen reporting, please include:\n- Your Node.js and npm versions.\n- The minimal steps to reproduce the bug.\n- The state of your repository if relevant (e.g., clean, dirty, behind remote).\n\n## ⚖️ License and Credits\n\n- **License**: MIT © [Ayush Saxena](https://github.com/a4ayush) (See the [LICENSE](LICENSE) file for details)\n- **Author**: [Ayush Saxena](https://github.com/a4ayush)\n- **Contributors**: [Orion](https://orionaix.com/) (AI collaborator)\n- **Powered by**: `@clack/prompts`, `chalk`, and `simple-git`.\n\n---\n\n*“May your branches stay clean and your streaks stay alive.”*","readmeFilename":"README.md"}