# workroom base

> Set or clear the branch new workrooms start from.

This page describes a feature only in Nightly builds.

<!-- Generated from the CLI by `make docs-cli`. Don't edit by hand. -->

## Synopsis

Set or clear the branch new workrooms start from. BRANCH is a branch on origin, such as develop, or &lt;remote>/&lt;branch> for another remote, such as upstream/main. Workroom fetches that remote and uses its copy of the branch, else the local branch. A project's own base wins over the --global one. Unset, new workrooms start from origin's default branch.

## Options

```text
  -h, --help   help for base
```

## Options inherited from parent commands

```text
      --json      Emit machine-readable JSON (exactly one object on stdout)
  -p, --pretend   Run through the command without making changes (dry run)
  -v, --verbose   Print detailed and verbose output
```

## See also

* [workroom](/workroom/docs/cli/workroom.md)	 - Manage development workrooms
* [workroom base clear](/workroom/docs/cli/workroom-base-clear.md)	 - Start new workrooms from the global base, else origin's default branch
* [workroom base set](/workroom/docs/cli/workroom-base-set.md)	 - Start new workrooms from BRANCH