rm
verbdestructiveRemove files, or directories and everything below them with -r.
Program anyfs-writer. Origin anyfs.
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 | destructive |
idempotent | false |
audience | both |
tier | writer |
dryRun | true |
check | false |
reachChannels | local, mcp |
reachReadOnly | false |
reachNeedsTty | false |
reachRunsAs | caller |
reachConfirmation | flag |
Operands
| Operand | Meaning |
|---|---|
LOCATION | Files, or directories with -r. |
Options
| Option | Meaning | Properties |
|---|---|---|
--recursive | Remove directories and everything below them. | type=flag, short=r, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--force | No error where a name is not there. | type=flag, short=f, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--plan-hash | Remove only what the plan with this hash lists, which --dry-run printed: if the names changed since, nothing is removed. | type=value, required=false, standard=false, humanOnly=false, valueName=HASH |
--explain | Say how the store would carry the operation out (native, emulated or refused), and do nothing else. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--strict | Stop where the store carries an operation out by a means that can lose or change what you meant. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--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 |
--yes | Confirm the destruction without asking. | type=flag, short=y, required=false, standard=true, humanOnly=false, negatable=false, default=false |
Examples
anyfs rm -r --dry-run fleet:/retired # The names that would go, and the hash of that list.
anyfs rm -r --yes --plan-hash <hash> fleet:/retired # Remove exactly that list.Physical: what it is drawn as
anyfs rm
cli-command. Remove files, or directories and everything below them with -r.
| Property | Value |
|---|---|
usage | anyfs rm |
words | rm |
tier | writer |
anyfs_rm
mcp-tool. Remove files, or directories and everything below them with -r. (action, effect destructive.)
| Property | Value |
|---|---|
title | anyfs rm |
toolName | anyfs_rm |
readOnlyHint | false |
destructiveHint | true |
idempotentHint | false |
inputs | recursive, force, planHash, explain, strict, dryRun, LOCATION |
required | LOCATION |
tier | writer |
Not drawn
- rest: its reach policy does not name the rest channel