Documentation

CLI reference / Maintain

cumaru fs

Move, copy, create, or remove one path inside .cumaru/ with guardrails.

Synopsis

cumaru fs <src> move|copy <dst>
cumaru fs <path> create|remove

Arguments and options

Argument or optionMeaning
move <dst>Move or rename a file or directory. Refuses an existing destination.
copy <dst>Copy a file or directory. Refuses an existing destination.
createCreate an empty directory, or an empty file when the path ends in .md. An existing path is a no-op.
removeDelete a file or directory.

Side effects

  • Writes: Yes, one path per call. There is no rollback: a failed recursive copy or removal can leave partial results.
  • Network: None.

Behavior

  • Paths are relative to .cumaru/. .. segments and leading / are rejected; direct symlink targets are refused.
  • Files must end in .md; directory names must not contain dots.
  • remove refuses files named index.md and direct children of .cumaru/ (pillar roots). Remove the entity directory instead.
  • fs does not edit content or validate what it creates; run cumaru doctor afterward.

Example

cumaru fs exploring/auth-redesign/index.md create

Failures

  • Exit 1: guardrail violation, missing source, existing destination, or write failure.
  • Exit 2: unknown verb or wrong argument count.

Sources: docs/fs.md; cumaru fs --help of CLI 0.15.3.

Back to all commands