bisync
verbdestructiveMake two directories equal both ways against a recorded base, with a rule for what both changed.
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 |
|---|---|
A | The first directory. |
B | The second directory. |
Options
| Option | Meaning | Properties |
|---|---|---|
--conflict | What to do with a path both sides changed: fail, newer-wins or keep-both. | type=value, required=false, standard=false, humanOnly=false, valueName=RULE, default=fail |
--seed | The first run: take the union of the two sides as the base. Needed once, and only where no base is recorded. | type=flag, required=false, standard=false, humanOnly=false, negatable=false, default=false |
--max-deletes | Let a delete on one side reach the other, at most N: none without it. | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--include | Only paths that match a glob (a * is within one name, ** crosses directories); give it again for more. | type=many, required=false, standard=false, humanOnly=false, valueName=GLOB |
--exclude | Leave out paths that match a glob; give it again for more. | type=many, required=false, standard=false, humanOnly=false, valueName=GLOB |
--concurrency | At most N actions at once (the configuration's by default). | type=value, required=false, standard=false, humanOnly=false, valueName=N |
--plan-hash | Apply only the plan with this hash, which a --dry-run printed: if the stores changed since, nothing is applied. | type=value, required=false, standard=false, humanOnly=false, valueName=HASH |
--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 bisync --seed --dry-run ./fleet s3backup:/fleet # The first run's plan: the union of both sides is the base.
anyfs bisync --conflict keep-both --dry-run ./fleet s3backup:/fleet # Later runs: only what changed since the base.Physical: what it is drawn as
anyfs bisync
cli-command. Make two directories equal both ways against a recorded base, with a rule for what both changed.
| Property | Value |
|---|---|
usage | anyfs bisync |
words | bisync |
tier | writer |
anyfs_bisync
mcp-tool. Make two directories equal both ways against a recorded base, with a rule for what both changed. (action, effect destructive.)
| Property | Value |
|---|---|
title | anyfs bisync |
toolName | anyfs_bisync |
readOnlyHint | false |
destructiveHint | true |
idempotentHint | false |
inputs | conflict, seed, maxDeletes, include, exclude, concurrency, planHash, dryRun, A, B |
required | A, B |
tier | writer |
Not drawn
- rest: its reach policy does not name the rest channel