repos add
verbmutateAdd repositories to the list of the workspace: `ergonex repos add github.com/owner/repo`; `ergonex apply` clones them.
Program ergonex-administrator. 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.
| Property | Value |
|---|---|
kind | action |
effect | mutate |
idempotent | true |
audience | both |
tier | public |
dryRun | true |
check | false |
reachChannels | local |
reachReadOnly | false |
reachNeedsTty | false |
reachRunsAs | caller |
reachConfirmation | none |
Operands
| Operand | Meaning |
|---|---|
REMOTE | A 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
| Option | Meaning | Properties |
|---|---|---|
--home | The root of the workspace for this run (else $ERGONEX_HOME, else $HOME/workspaces). | type=value, required=false, standard=false, humanOnly=false, valueName=DIR |
--branch | The branch to keep checked out (a page's address, `.../tree/dev`, names it too). | type=value, required=false, standard=false, humanOnly=false, valueName=BRANCH |
--group | A name that groups repositories together. | type=value, required=false, standard=false, humanOnly=false, valueName=GROUP |
--json | Write one JSON document and nothing else for a person. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--quiet | Show only how it ended. | type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--verbose | Show every step as it happens. | type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--color | Use colour where the terminal shows it (--no-color turns it off). | type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true |
--non-interactive | Never ask a question: where one is needed, fail and say so. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--dry-run | Show 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.
| Property | Value |
|---|---|
usage | ergonex repos add |
words | repos, add |
tier | public |
Not drawn
- mcp: its reach policy does not name the mcp channel
- rest: its reach policy does not name the rest channel