diff --git a/README.md b/README.md index a43ef8a..a50355b 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,7 @@ https://github.com/user-attachments/assets/88eb4aed-c00d-4238-b1a9-bcaa34c975c3 # From within a git repository par start feature-auth # Creates worktree, branch, and tmux session par start feature-auth --base develop +par start feature-auth --pull-default # Pull default branch first # From anywhere on your system par start bugfix-login --path /path/to/repo @@ -60,6 +61,7 @@ par control-center # View ALL sessions and workspaces globally with separ ```bash par workspace start feature-auth --repos frontend,backend +par workspace start feature-auth --repos frontend,backend --pull-default # Pull default branch first par workspace code feature-auth # Open in VSCode with multi-repo support par workspace open feature-auth # Attach to unified tmux session ``` @@ -134,6 +136,7 @@ Create a new isolated development environment: # From within a git repository par start my-feature par start my-feature --base develop +par start my-feature --pull-default # From anywhere, specifying the repository path par start my-feature --path /path/to/your/git/repo @@ -142,6 +145,8 @@ par start my-feature -p ~/projects/my-app By default, `par start` branches from the current `HEAD` commit. Use `--base` to branch from a specific branch/reference. `par` resolves the base to a commit SHA, so uncommitted changes in your current worktree do not affect the new branch. +Use `--pull-default` to pull the repository's default branch (determined via `origin/HEAD`) before creating the worktree branch. If no `--base` is provided, the new branch will be based on the freshly pulled default branch. If both `--pull-default` and `--base` are provided, the default branch is still pulled but `--base` takes precedence for the branch point. + If the label already matches an existing local branch, `par start