feat: add LICENSE and README files for project documentation

Author: dominusmmp

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 dominusmmp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

readme.md

@@ -0,0 +1,122 @@
+# GitSwitch
+
+A tiny tool to switch between GitHub accounts using the `gh` CLI and configure Git user settings.
+
+## Features
+
+- Switch GitHub accounts with `gh auth switch`.
+- Set global or local (`--single`) Git user.name and user.email.
+- Support for custom email (`--email`) and hostname (`--hostname`).
+- Unset local Git settings with `--unset-single`.
+
+## Installation
+
+### Automatic Installation/Update
+
+Run one of the following commands to download and execute the installer:
+
+Using `curl`:
+
+```bash
+curl -fsSL https://git.new/gitswitch | bash
+```
+
+Using `wget`:
+
+```bash
+wget -qO- https://git.new/gitswitch | bash
+```
+
+This installs `gitswitch` to `/usr/local/bin` or `$HOME/.local/bin` and sets up dependencies (`gh`, `jq`).
+
+### Manual Installation
+
+In case the automatic installer fails:
+
+1. **Download the script**:
+
+   ```bash
+   curl -fsSL "https://git.new/git-switch" -o gitswitch.sh
+   ```
+
+   or
+
+   ```bash
+   wget -qO gitswitch.sh "https://git.new/git-switch"
+   ```
+
+2. **Make it executable**:
+
+   ```bash
+   chmod +x gitswitch.sh
+   ```
+
+3. **Move to a bin directory**:
+
+   ```bash
+   sudo mv gitswitch.sh /usr/local/bin/gitswitch
+   ```
+
+   or
+
+   ```bash
+   mv gitswitch.sh $HOME/.local/bin/gitswitch
+   ```
+
+4. **Ensure dependencies**: Install `git`, `gh`, and `jq` using your package manager (e.g., `apt`, `dnf`, `brew`).
+
+5. **Add to PATH** (if using `$HOME/.local/bin`):
+
+   ```bash
+   echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
+   source ~/.bashrc
+   ```
+
+## Usage
+
+```bash
+gitswitch [--single] [--hostname <host>] [--email <email>] <username>
+gitswitch --unset-single
+gitswitch -h | --help
+```
+
+- `<username>`: GitHub username to switch to.
+- `--single`: Apply settings to the current repository only.
+- `--unset-single`: Remove local Git settings.
+- `--hostname`: Specify GitHub instance (default: github.com).
+- `--email`: Use a custom email instead of the default noreply email.
+
+## Examples
+
+Switch to a global GitHub account:
+
+```bash
+gitswitch myusername
+```
+
+Switch for the current repository only:
+
+```bash
+gitswitch --single myusername
+```
+
+Use a custom email and hostname:
+
+```bash
+gitswitch --hostname github.company.com --email user@company.com myusername
+```
+
+Unset local repository settings:
+
+```bash
+gitswitch --unset-single
+```
+
+## Notes
+
+- Ensure you are logged in with `gh auth login -u <username> -h <hostname>` before switching.
+- Local option (`--single`) only affects the current repository's git user settings; Still the `gh` user change applies globally (even if `--single` is used).
+
+## License
+
+Licensed under the MIT License. See [LICENSE](LICENSE) for details.