\n # g4c - Git for Cloud \n A basic pure js git CLI implementation based on isomorphic-git.
\n \n \n
\n \n\n\n- [Issue tracker](https://gitlab.com/vblip/g4c/-/issues)\n- [Merge requests](https://gitlab.com/vblip/g4c/-/merge_requests)\n- [GitHub mirror](https://github.com/FossPrime/g4c)\n- [NPM](https://www.npmjs.com/package/g4c)\n\n\n## Commands supported\n\n```sh\n- g4c clone URL\n- g4c clone URL DIRECTORY\n- g4c clone # (automatically clones from package.json, or secrets file)\n- g4c checkout --force HEAD\n- g4c pull\n- g4c pull --ff-only\n- g4c status\n- g4c add --all\n- g4c commit -m \"My commit message\"\n- g4c push\n```\n\n**TODO:**\n\n```sh\n- git # As an alias, comming soon\n- g4c add FILE(s)\n- g4c add .\n- git pull origin pull/123/head\n```\n\n\n## Setup\n\n- `npm i -D g4c`\n- `npm i -g g4c` -- Global install\n\n\n\n## Goals\n\n1. **Make common git commands easy to use in JavaScript shells 🚀**\n * This includes commands such as `git clone`, `git pull`, and `git push`.\n2. **Provide configuration options via config file, package.json and ENV variables ⚙️**\n * This will make it easier for developers to customize the behavior of g4c to match their specific needs.\n3. **Minimize cold-boot time and overhead in browser environments ⏱️**\n * This is important for web IDEs. By minimizing the cold-boot time, developers can maximize cycle time and review PR's more efficiently.\n4. **Improve the developer experience (DX) for JS devs as much as possible 👩💻**\n * Following in the foot steps of vite and git to improve workflows.\n\n### Configuration Precedence\n\n- First, the long form package.json -> repository field is read\n- Then, package.json -> author field is read for email and name\n- Then, package.json -> g4c\n- Finally, SECRETS.g4c.json can veto all others\n- Unless, yoy provided an argument in the command line\n\nAll of these are optional:\n\n```\n// SECRETS.g4c.json\n{\n \"proxy\": \"https://cors.isomorphic-git.org\",\n \"useProxyOnBareMetal\": false,\n \"username\": \"inu\",\n \"password\": \"neko\",\n \"authorName\": \"John Doe\",\n \"authorEmail\": \"john@example.com\",\n \"repoUrl\": \"https://github-sucks.com/user/project.git\"\n}\n```\n","readmeFilename":"README.md"}
![\"G4C](\"https://unpkg.com/g4c@1.2.2/docs/logo.svg\"){kind=logo}
\n \n![\"Open](\"https://developer.stackblitz.com/img/open_in_stackblitz.svg\")
\n \n