create-gitwrap v1.0.1

gitwrap

Git init & clone wrapper for multiple keys.

Warning This create- package is not a template. It will write to your system binaries. It also does not work on Windows.

Installation

pnpm create gitwrap

Note: You may need a GPG key already generated. You will need an SSH key. You will need pnpm globally installed.

1. Select if you want to sign commits with GPG by default.
2. Select your GPG Key and identity. It will autofill your username and email based on this when possible, aswell as specify this as your signing key within repos you init.
3. If we couldn't identify your username and email, enter those under Username and Email
4. Select your SSH key. This will be used for cloning repos and pushing. If you don't notice anything when normally using git, use the default.
5. Optional: Select a binary name to write to - if this starts with git (ie git codeberg), it'll be used as a git alias. Otherwise, it'll be a standalone binary in ~/.local/bin (if your distribution does not have this, symlink it to a directory in your PATH you have access to).
6. Optional: Change the default branch - this is used when initing
7. Optional: Change the default subcommand - this is used when the command is called with no arguments.
8. Select Finish, then press Yes to install.
9. Congrats!

Usage

Git

Most commands are syntax 1:1 compatible, inclulsive subcommands

Clone

<gitwrap> clone <repo> [directory]

Init

<gitwrap> init [directory]

Other

Other commands are called 1:1, using git ...args. If no args are specified, the default subcommand is used.

Additional commands

Uninstall

<gitwrap> uninstall

Uninstalls the binary (and, when applicable, removes the git config entry).