IF Commons GitHub

repos add

verbmutate

Add repositories to the list of the workspace: `ergonex repos add github.com/owner/repo`; `ergonex apply` clones them.

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
idempotenttrue
audienceboth
tierpublic
dryRuntrue
checkfalse
reachChannelslocal
reachReadOnlyfalse
reachNeedsTtyfalse
reachRunsAscaller
reachConfirmationnone

Operands

OperandMeaning
REMOTEA repository as you write it: `github.com/owner/repo`, `owner/repo` (GitHub), `gitlab:group/sub/repo`, `git@host:path.git` or an https address, with or without the scheme.

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
--branchThe branch to keep checked out (a page's address, `.../tree/dev`, names it too).type=value, required=false, standard=false, humanOnly=false, valueName=BRANCH
--groupA name that groups repositories together.type=value, required=false, standard=false, humanOnly=false, valueName=GROUP
--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
--dry-runShow what would change and change nothing.type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false

Examples

ergonex repos add github.com/owner/repo  # Put a repository on the list.
ergonex repos add owner/repo --branch dev --group core  # Put a GitHub repository on the list, on a branch, in a group.

Physical: what it is drawn as

ergonex repos add

cli-command. Add repositories to the list of the workspace: `ergonex repos add github.com/owner/repo`; `ergonex apply` clones them.

PropertyValue
usageergonex repos add
wordsrepos, add
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.