A snapshot: read at commit 707a04c7ce8 on 2026-10-18T00:06:01Z by majordomus 0.29.0. Nothing on this page is read again. See it live
majordomus worktree create
Create the canonical worktree of a branch. A branch that does not exist here is fetched from the trunk's remote and taken up when the remote has it; otherwise it is created from --base, else from the remote's trunk fetched now (the local trunk only when the remote cannot be read, and then said, with how far behind). The path is derived; none may be given
What it is
repository mutationCreate the canonical worktree of a branch. A branch that does not exist here is fetched from the trunk's remote and taken up when the remote has it; otherwise it is created from --base, else from the remote's trunk fetched now (the local trunk only when the remote cannot be read, and then said, with how far behind). The path is derived; none may be given
- Identity
executable.worktree.create- Program
- executable
- Runs
- non interactive
- Requires
- repository
No machine surface carries this command: effect RepositoryMutation is above the machine ceiling LocalMutation
Where it appears
- Command line
majordomus worktree create- Workflow
just worktree-create- MCP tool
- —
- HTTP
- —
- Declared in
apps/majordomus-cli/src/cli.rs- Capability
- —
Arguments
| argument | values from | required | help |
|---|---|---|---|
<BRANCH> | — | The branch, full name (`feature/improve-cli`) | |
--base | — | Start a new branch from this ref. Never fetched: it must resolve locally | |
--issue | — | Name the branch after this issue of .ai/repo/project/issues: `feature/<id>-<slug>`, the form the topology reads the issue back from | |
--repo | — | Start the search for the repository root here (default: the current directory) | |
--discovery | — | How declarative files are enumerated | |
--strict | — | Refuse to proceed when any file of the layer carries an error diagnostic | |
--share | — | The tool distribution's share directory (kinds.yaml, schemas/); default: $MAJORDOMUS_SHARE, then the repository's own share/, then the one beside the executable | |
--format | — | Output shape |