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 option | Meaning |
|---|---|
move <dst> | Move or rename a file or directory. Refuses an existing destination. |
copy <dst> | Copy a file or directory. Refuses an existing destination. |
create | Create an empty directory, or an empty file when the path ends in .md. An existing path is a no-op. |
remove | Delete 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.