gitsw [BRANCH]

gitsw [BRANCH] [OPTIONS]
```text

<ParamField path="BRANCH" type="string" optional>
  Target branch to switch to. If omitted, launches an interactive branch picker with fuzzy search.
</ParamField>

## Options

<ParamField path="--no-stash" type="flag">
  Skip automatic stash behavior. Uncommitted changes may prevent the switch if they conflict.
</ParamField>

<ParamField path="--no-install" type="flag">
  Skip automatic package installation prompts when lock files change.
</ParamField>

<ParamField path="-c, --create" type="flag">
  Create the branch if it doesn't exist. Without this flag, switching to a non-existent branch returns an error.
</ParamField>

<ParamField path="-p, --pull" type="flag">
  Pull latest changes from remote after switching to the branch.
</ParamField>

## Behavior

The `switch_branch` function executes the following steps:

### 1. Pre-switch validation
- Checks if the target branch exists (unless `-c` is specified)
- If already on the target branch, displays info message and optionally pulls if `-p` is set
- Updates the last visited timestamp for the current branch

### 2. Handle uncommitted changes
If auto-stash is enabled (default) and there are uncommitted changes:
- Prompts user to **Stash**, **Discard**, or **Abort**
- If stashing, saves with message: `git-switch: {branch_name}`
- Stores stash OID and lock file hash in state
- Displays: `info: Stashing changes on '{branch}'...`

If `--no-stash` is set:
- Displays warning: `warning: Skipping stash (--no-stash), uncommitted changes may prevent switch`

### 3. Create and switch
- Creates branch if `-c` flag is set and branch doesn't exist
- Executes Git checkout to target branch
- Displays: `done: Switched to '{branch}'`

### 4. Restore stashed changes
If a stash exists for the target branch:
- Displays: `info: Found stashed changes for this branch`
- Attempts to apply and drop the stash
- On success: `done: Restored stashed changes.`
- On conflict: Prompts to **Apply** (keep conflicts), **Skip**, or **Abort**

### 5. Pull if requested
If `-p` flag is set:
- Executes `git pull` on the current branch
- Displays: `info: Pulling latest changes...`
- On success: `done: Pull completed.`

### 6. Handle package installation
If auto-install is enabled (default):
- Compares current lock file hash with stored hash
- If different, prompts to run package manager install
- Supports npm, yarn, and pnpm
- Updates stored lock file hash after install

### 7. Update tracking
- Updates last visited timestamp for target branch
- Saves state to `.git/git-switch.json`

## Examples

### Interactive mode
```bash
gitsw

gitsw main
```bash
Switches to `main` branch. If uncommitted changes exist, prompts to stash.

### Create and switch to new branch
```bash
gitsw -c feature-login

gitsw main -p
```bash
Switches to `main` and pulls latest changes from remote.

### Switch without stashing
```bash
gitsw develop --no-stash

gitsw -c -p feature-api
```bash
Creates `feature-api`, switches to it, and pulls from remote.

### Switch without install prompt
```bash
gitsw main --no-install