# rebase

Rebases a worktree branch onto its saved base branch. If the branch does not have a saved local base branch, workrex rebases onto the configured main branch.

```bash
workrex rebase [name]
```

## Arguments

- `[name]`: Optional worktree name or branch. If omitted, workrex detects the current worktree from the current directory.

## What happens

1. Determines which worktree branch to rebase
2. Reads the saved base branch recorded when the worktree was created
3. Falls back to the configured main branch when the saved base is not a local branch
4. Runs `git rebase <base>` inside the worktree
5. Leaves the worktree, window, and branch in place

## Remote workspaces

For a workspace on a [remote server](https://kong109.github.io/workrex/guide/remote/), workrex sends your local base branch to the remote and runs the rebase there, committing as your local git identity. The agent keeps running. On a conflict, the rebase stops in the remote worktree: open the workspace and run `git rebase --continue` or `git rebase --abort` in its shell pane.

## Examples

```bash
workrex rebase user-auth
workrex rebase
```