Improve commands

Author: SimonSchubert

assets/commands/git-ls-remote.md

@@ -51,6 +51,9 @@ _REFS_
 **--exit-code**
 > Exit with error if no refs found.
 
+**--symref**
+> Show underlying ref for symbolic refs (e.g. what HEAD points to).
+
 **--help**
 > Display help information.
 
@@ -71,3 +74,13 @@ git ls-remote is a core **Git** command for inspecting remote references, useful
 # SEE ALSO
 
 [git-remote](/man/git-remote)(1), [git-fetch](/man/git-fetch)(1), [git-ls-tree](/man/git-ls-tree)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/git/git)```
+
+```[Homepage](https://git-scm.com/)```
+
+```[Documentation](https://git-scm.com/docs/git-ls-remote)```
+
+<!-- verified: 2026-07-17 -->

assets/commands/git-ls-tree.md

@@ -74,3 +74,13 @@ git ls-tree is a core **Git** plumbing command for examining tree objects, part
 # SEE ALSO
 
 [git-ls-files](/man/git-ls-files)(1), [git-ls-remote](/man/git-ls-remote)(1), [git-show](/man/git-show)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/git/git)```
+
+```[Homepage](https://git-scm.com/)```
+
+```[Documentation](https://git-scm.com/docs/git-ls-tree)```
+
+<!-- verified: 2026-07-17 -->

assets/commands/git-magic.md

@@ -1,23 +1,75 @@
 # TAGLINE
 
-Display advanced usage tips
+Commit changes with an auto-generated commit message
 
 # TLDR
 
-**Show git magic help**
+**Commit staged changes** with a generated message
 
 ```git magic```
 
+**Stage all changes** (with confirmation) and commit
+
+```git magic -a```
+
+**Commit and push**
+
+```git magic -p```
+
+**Commit and force-push**
+
+```git magic -p -f```
+
+**Prepend a custom title** before the generated message
+
+```git magic -m "[title]"```
+
+**Edit the generated message** before committing
+
+```git magic -e```
+
 # SYNOPSIS
 
-**git** **magic**
+**git** **magic** [_-a_] [_-m_ _msg_] [_-e_] [_-p_] [_-f_]
+
+# PARAMETERS
+
+**-a**
+> Stage all changes (after confirmation) before committing.
+
+**-m** _msg_
+> Prepend a custom message; the generated summary is appended after it.
+
+**-e**
+> Open the editor to review the message instead of committing with `--no-edit`.
+
+**-p**
+> Push after committing.
+
+**-f**
+> Force-push; only takes effect combined with `-p`.
+
+**-h**
+> Display usage information.
 
 # DESCRIPTION
 
-**git magic** displays help and tips for advanced Git usage. This git-extras command provides a quick reference guide for common Git operations, tricks, and advanced techniques directly from the command line.
+**git magic** is a git-extras command that commits changes using an automatically generated commit message built from `git status --porcelain -uno`, so the message ends up listing the files that changed. By default the commit happens without opening an editor (`--no-edit`).
+
+Passing `-a` shows `git status`, asks for confirmation, then stages everything before committing. `-m` lets you prepend a real message before the auto-generated summary, `-e` opens an editor to adjust the final message, and `-p` (optionally with `-f` for a force-push) pushes immediately after the commit.
 
-The output includes shortcuts, useful aliases, and lesser-known Git features that can improve productivity. It serves as a curated cheat sheet for intermediate Git users looking to expand their knowledge beyond basic commands.
+# CAVEATS
+
+Must be run inside a git working tree; it changes to the repository's top level automatically. The generated message is just a list of changed files, not a meaningful description, so this is best suited for quick WIP commits rather than history you intend to keep readable.
 
 # SEE ALSO
 
-[git-extras](/man/git-extras)(1), [git-help](/man/git-help)(1)
+[git-commit](/man/git-commit)(1), [git-extras](/man/git-extras)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/tj/git-extras)```
+
+```[Documentation](https://github.com/tj/git-extras/blob/master/Commands.md#git-magic)```
+
+<!-- verified: 2026-07-17 -->

assets/commands/git-mailinfo.md

@@ -56,3 +56,13 @@ git mailinfo is part of **Git's** email patch workflow, supporting the patch-by-
 # SEE ALSO
 
 [git-am](/man/git-am)(1), [git-mailsplit](/man/git-mailsplit)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/git/git)```
+
+```[Homepage](https://git-scm.com/)```
+
+```[Documentation](https://git-scm.com/docs/git-mailinfo)```
+
+<!-- verified: 2026-07-17 -->

assets/commands/git-mailsplit.md

@@ -56,3 +56,13 @@ git mailsplit is part of **Git's** email patch workflow, breaking mailboxes into
 # SEE ALSO
 
 [git-am](/man/git-am)(1), [git-mailinfo](/man/git-mailinfo)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/git/git)```
+
+```[Homepage](https://git-scm.com/)```
+
+```[Documentation](https://git-scm.com/docs/git-mailsplit)```
+
+<!-- verified: 2026-07-17 -->

assets/commands/git-merge-index.md

@@ -36,3 +36,13 @@ The command passes file information (including base, ours, and theirs versions w
 # SEE ALSO
 
 [git-merge](/man/git-merge)(1), [git-mergetool](/man/git-mergetool)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/git/git)```
+
+```[Homepage](https://git-scm.com/)```
+
+```[Documentation](https://git-scm.com/docs/git-merge-index)```
+
+<!-- verified: 2026-07-17 -->

assets/commands/git-merge-repo.md

@@ -32,18 +32,28 @@ _DIRECTORY_
 
 # DESCRIPTION
 
-**git merge-repo** merges another repository into a subdirectory while preserving its full commit history. It handles the complex process of combining two separate repository histories with directory relocation.
+**git merge-repo** merges another repository into a subdirectory while preserving its full commit history. It is a thin wrapper around `git subtree add -P <directory> <repo> <branch>`, so the incoming history is grafted in rather than squashed away.
+
+Passing `.` as the directory is a special case: the repo is first added into a temporary subdirectory, then its files are moved up into the repository root (flattening it) instead of staying nested.
 
 The command is useful for incorporating external libraries, consolidating multiple repositories into a monorepo, or absorbing a project that was previously maintained separately.
 
 # CAVEATS
 
-Part of git-extras package. Complex operation. May need conflict resolution.
+Part of git-extras package. Requires `git subtree` to be available. May need conflict resolution if paths collide.
 
 # HISTORY
 
 git merge-repo is part of **git-extras**, providing repository consolidation functionality for monorepo creation and library incorporation.
 
 # SEE ALSO
 
-[git-merge](/man/git-merge)(1), [git-subtree](/man/git-subtree)(1)
+[git-merge](/man/git-merge)(1), [git-subtree](/man/git-subtree)(1), [git-extras](/man/git-extras)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/tj/git-extras)```
+
+```[Documentation](https://github.com/tj/git-extras/blob/master/Commands.md#git-merge-repo)```
+
+<!-- verified: 2026-07-17 -->

assets/commands/git-mergetool--lib.md

@@ -29,3 +29,13 @@ git-mergetool--lib is part of **Git's** internal infrastructure, providing share
 # SEE ALSO
 
 [git-mergetool](/man/git-mergetool)(1), [git-difftool](/man/git-difftool)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/git/git)```
+
+```[Homepage](https://git-scm.com/)```
+
+```[Documentation](https://git-scm.com/docs/git-mergetool--lib)```
+
+<!-- verified: 2026-07-17 -->

assets/commands/git-mergetool.md

@@ -45,6 +45,9 @@ _FILE_
 **--prompt**
 > Prompt before each file.
 
+**-g**, **--gui**
+> Use `merge.guitool` instead of `merge.tool`.
+
 **--help**
 > Display help information.
 
@@ -78,3 +81,13 @@ git mergetool is a core **Git** command providing integration with external merg
 # SEE ALSO
 
 [git-merge](/man/git-merge)(1), [git-difftool](/man/git-difftool)(1), [vimdiff](/man/vimdiff)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/git/git)```
+
+```[Homepage](https://git-scm.com/)```
+
+```[Documentation](https://git-scm.com/docs/git-mergetool)```
+
+<!-- verified: 2026-07-17 -->

assets/commands/git-mktree.md

@@ -38,7 +38,7 @@ Create tree object from ls-tree format
 
 **git mktree** creates a tree object from ls-tree formatted input. It reads file modes, object types, hashes, and names from stdin, creating a new tree object containing those entries. The command is the inverse of `git ls-tree`.
 
-This plumbing tool enables programmatic tree creation and manipulation in scripts. Input must be properly formatted with each line specifying mode, type, hash, and filename.
+This plumbing tool enables programmatic tree creation and manipulation in scripts. Input must be properly formatted with each line specifying mode, type, hash, and filename. With `--batch`, it accepts multiple tree descriptions separated by blank lines and writes one tree object per batch, printing each resulting hash.
 
 # CAVEATS
 
@@ -51,3 +51,13 @@ git mktree is a core **Git** plumbing command for tree object creation, enabling
 # SEE ALSO
 
 [git-ls-tree](/man/git-ls-tree)(1), [git-write-tree](/man/git-write-tree)(1)
+
+# RESOURCES
+
+```[Source code](https://github.com/git/git)```
+
+```[Homepage](https://git-scm.com/)```
+
+```[Documentation](https://git-scm.com/docs/git-mktree)```
+
+<!-- verified: 2026-07-17 -->