IF Commons GitHub

worktree create

verbmutate

Make a worktree for an issue's branch, only where someone else or uncommitted work is on the repository.

Program ergonex-operator. Origin ergonex.

Governance: the action

What the verb is and may do, as governance says it. Each annotation is expressed by the surfaces or says why it is not.

PropertyValue
kindaction
effectmutate
idempotentfalse
audienceboth
tierpublic
dryRunfalse
checkfalse
reachChannelslocal
reachReadOnlyfalse
reachNeedsTtyfalse
reachRunsAscaller
reachConfirmationnone

Operands

OperandMeaning
REPOSITORYThe repository: its path in the workspace, or its name where that is only one.
BRANCHThe branch, named for its issue (`10-ergonex-host`, `issue-10`, `0020-ifccm`).

Options

OptionMeaningProperties
--homeThe root of the workspace for this run (else $ERGONEX_HOME, else $HOME/workspaces).type=value, required=false, standard=false, humanOnly=false, valueName=DIR
--alwaysMake the worktree even where the repository's own checkout is free.type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false
--jsonWrite one JSON document and nothing else for a person.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false
--quietShow only how it ended.type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false
--verboseShow every step as it happens.type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false
--colorUse colour where the terminal shows it (--no-color turns it off).type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true
--non-interactiveNever ask a question: where one is needed, fail and say so.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false

Examples

ergonex worktree create tool 10-ergonex-host  # Make a worktree for issue 10 where someone else or uncommitted work is on the repository.

Physical: what it is drawn as

ergonex worktree create

cli-command. Make a worktree for an issue's branch, only where someone else or uncommitted work is on the repository.

PropertyValue
usageergonex worktree create
wordsworktree, create
tierpublic

Not drawn

  • mcp: its reach policy does not name the mcp channel
  • rest: its reach policy does not name the rest channel

Titles, headings, exports, tables, columns and requirements. Esc closes.