resulgit
A powerful command-line interface (CLI) tool for version control system operations.
Installation
``bash
npm install -g resulgit
`
Or install locally:
`bash
npm install resulgit
`
Usage
`bash
resulgit [options]
`
Commands
$3
- resulgit auth set-token --token - Set authentication token
- resulgit auth set-server --server - Set server URL
- resulgit auth login --email --password - Login to server
- resulgit auth register --username --email --password - Register new account
$3
- resulgit repo list - List all repositories
- resulgit repo create --name [--description ] [--visibility ] - Create new repository
- resulgit repo log --repo [--branch ] - View commit log
- resulgit repo head --repo [--branch ] - Get HEAD commit
- resulgit repo select - Interactive repository selection
$3
- resulgit init - Initialize a new repository (creates folder and remote repo automatically)
- resulgit init --dir - Initialize in a specific directory
- resulgit clone - Clone a repository by name
- resulgit clone --repo --branch - Clone with specific branch
- resulgit workspace set-root --path - Set workspace root directory
$3
- resulgit branch list - List all branches
- resulgit branch create - Create new branch (simple)
- resulgit branch create --base - Create from specific base
- resulgit branch delete - Delete a branch
- resulgit switch - Switch to a branch
- resulgit switch -c - Create and switch to new branch
- resulgit checkout - Checkout a branch
- resulgit merge - Merge a branch into current
$3
- resulgit status - Show working directory status
- resulgit diff [--path ] [--commit ] - Show differences
- resulgit add [--content ] [--all] - Add files
- resulgit rm --path - Remove files
- resulgit mv --from --to - Move/rename files
- resulgit restore --path [--source ] - Restore file from commit
$3
- resulgit commit --message - Create a commit
- resulgit commit -m - Short form (same as above)
- resulgit commit -a -m - Add all changes and commit
- resulgit push - Push changes to remote
- resulgit pull - Pull changes from remote
- resulgit merge --branch [--squash] [--no-push] - Merge branches
- resulgit cherry-pick --commit [--branch ] [--no-push] - Cherry-pick a commit
- resulgit revert --commit [--no-push] - Revert a commit
- resulgit reset [--commit ] [--mode ] - Reset to commit
$3
- resulgit stash or resulgit stash save [--message ] - Save changes to stash
- resulgit stash list - List all stashes
- resulgit stash pop [--index ] - Apply and remove stash
- resulgit stash apply [--index ] - Apply stash without removing
- resulgit stash drop [--index ] - Delete a stash
- resulgit stash clear - Clear all stashes
$3
- resulgit tag list - List all tags
- resulgit tag create --name [--branch ] - Create a tag
- resulgit tag delete --name - Delete a tag
$3
- resulgit pr list - List pull requests
- resulgit pr create --title
[--source <branch>] [--target <branch>]<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Create pull request<br />- </code>resulgit pr merge --id <id><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Merge a pull request</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3">- </code>resulgit current<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Show current repository and branch<br />- </code>resulgit head<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Show HEAD commit ID<br />- </code>resulgit show --commit <id><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Show commit details<br />- </code>resulgit log [--branch <name>] [--max <N>] [--oneline] [--stats]<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Show commit history with visualization<br />- </code>resulgit blame --path <file><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Show line-by-line authorship information<br />- </code>resulgit grep --pattern <pattern> [--ignore-case]<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Search for patterns in repository<br />- </code>resulgit ls-files<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - List all tracked files<br />- </code>resulgit reflog<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Show reference log history<br />- </code>resulgit cat-file --type <type> --object <id> [--path <file>]<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Display file/commit contents<br />- </code>resulgit rev-parse --rev <ref><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Parse revision names to commit IDs<br />- </code>resulgit describe [--commit <id>]<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Describe a commit with nearest tag<br />- </code>resulgit shortlog [--branch <name>] [--max <N>]<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Summarize commit log by author</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3">- </code>resulgit hook list<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - List installed hooks<br />- </code>resulgit hook install --name <hook> [--script <code>] [--sample]<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Install a hook<br />- </code>resulgit hook remove --name <hook><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Remove a hook<br />- </code>resulgit hook show --name <hook><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Show hook content</p><p class="my-3"><strong>Available hooks:</strong> </code>pre-commit<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>post-commit<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>pre-push<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>post-push<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>pre-merge<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>post-merge<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>pre-checkout<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">, </code>post-checkout<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">Global Options</h2></p><p class="my-3">- </code>--server <url><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Override default server<br />- </code>--token <token><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Override stored token<br />- </code>--json<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Output in JSON format<br />- </code>--dir <path><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> - Specify working directory</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">Examples</h2></p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">bash<br /><h1 class="text-2xl font-bold mt-6 mb-4">Login to server</h1><br />resulgit auth login --email user@example.com --password mypassword</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">List repositories</h1><br />resulgit repo list</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Initialize a new repository (creates folder + remote repo automatically)</h1><br />resulgit init MyProject</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Or clone an existing repository</h1><br />resulgit clone MyProject</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Check status</h1><br />cd MyProject<br />resulgit status</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Create and commit changes</h1><br />resulgit add file.txt --content "Hello World"<br />resulgit commit -m "Add file.txt"<br />resulgit push</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Create a branch</h1><br />resulgit branch create --name feature-branch</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Merge branches</h1><br />resulgit merge --branch feature-branch</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">View commit history with graph</h1><br />resulgit log --max 20</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">View commit history in one line</h1><br />resulgit log --oneline</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">View commit statistics</h1><br />resulgit log --stats</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Show line-by-line authorship</h1><br />resulgit blame --path src/index.js</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Search in repository</h1><br />resulgit grep --pattern "TODO"</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">List tracked files</h1><br />resulgit ls-files</p><p class="my-3"><h1 class="text-2xl font-bold mt-6 mb-4">Install a pre-commit hook</h1><br />resulgit hook install --name pre-commit --sample<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">Configuration</h2></p><p class="my-3">Configuration is stored in </code>~/.resulgit/config.json<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">. You can set:<br />- </code>server<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">: Default server URL<br />- </code>token<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">: Authentication token<br />- </code>workspaceRoot`: Default workspace directory</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">License</h2></p><p class="my-3">MIT</p><p class="my-3"></p></div><div class="flex justify-center absolute inset-x-0 bottom-0 bg-gradient-to-t from-background via-background to-transparent pb-4 pt-16"><button data-slot="button" class="inline-flex items-center justify-center whitespace-nowrap text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50 h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down mr-1 h-4 w-4"><path d="m6 9 6 6 6-6"></path></svg>Show more</button></div></div></div><template id="P:3"></template><template id="P:4"></template></div></div></div><script>self.__next_f.push([1,"2b:[\"$\",\"div\",null,{\"data-slot\":\"card-content\",\"className\":\"px-6\",\"children\":[\"$\",\"div\",null,{\"className\":\"grid gap-1 sm:grid-cols-2 lg:grid-cols-3\",\"children\":[[\"$\",\"$L5\",\"jest\",{\"href\":\"/package/jest\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"jest\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^29.7.0\"}]]}]]}]}]\n"])</script><div hidden id="S:3"><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-dependencies" hidden="" id="radix-_R_aav5ubrb_-content-dependencies" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div></div><script>$RS=function(a,b){a=document.getElementById(a);b=document.getElementById(b);for(a.parentNode.removeChild(a);a.firstChild;)b.parentNode.insertBefore(a.firstChild,b);b.parentNode.removeChild(b)};$RS("S:3","P:3")</script><div hidden id="S:4"><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-versions" hidden="" id="radix-_R_aav5ubrb_-content-versions" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div></div><script>$RS("S:4","P:4")</script><script>$RC("B:1","S:1")</script></body></html>