New-WorkBranch - GitEasy

New-WorkBranch Start a new working area for an isolated task, fix, or doc change.

Read / Write GitEasy v1.5.3

Description

New-WorkBranch creates a new working area starting from the current point and switches to it. Use it when starting a new feature, a bug fix, or a documentation pass that should not mix with the active working area.

The command refuses to start a new working area when an unfinished merge, rebase, cherry-pick, revert, or bisect is in progress, or when there are unfinished conflicts. It also rejects names that are not valid working-area identifiers (spaces, control characters, leading dashes, and similar) and refuses to overwrite a working area that already exists.

Each invocation writes a self-contained diagnostic log file. Successful runs log silently; failures throw a plain-English message and point at the log file with the technical detail.

Recipes

Recipe 1

EXAMPLE 1

New-WorkBranch -Name fix-readme

Recipe 2

EXAMPLE 2

Find-CodeChange; New-WorkBranch -Name docs-refresh

Notes

Safety:

Refuses to run during an unfinished merge, rebase, cherry-pick, revert, or bisect.
Refuses to run while there are unfinished conflicts.
Refuses to overwrite an existing working area.
Validates the name through git check-ref-format.

Parameters

-Name required String

The name of the new working area. Must be a valid identifier (no spaces, no control characters, no leading dash, etc.).

-LogPath optional String

Override the directory where the diagnostic log for this run is written. Defaults to %LOCALAPPDATA%\GitEasy\Logs.

-WhatIf optional SwitchParameter

-Confirm optional SwitchParameter

Was this page helpful? Report an issue or suggest an improvement →