All commands · evidence
pm item files
Manage files linked to an item.
Associates changed source files with tracker items for reproducibility.
Usage
pm item files [options] [command] <id>Arguments
| <id> | Item id | required |
|---|
Options
| --add <value> | Add linked file entry (CSV/markdown pairs or - for stdin) | optional |
|---|---|---|
| --add-glob <value> | Add linked file entries from a glob (plain glob or pattern=<glob>,scope=<scope>,note=<text>; repeatable) | optional |
| --remove <value> | Remove linked file by path only (path=<value>, path:<value>, plain path, or - for stdin); does not accept note=/scope= — record removal context with --message | optional |
| --migrate <value> | Migrate linked file paths in-place (from=<prefix>,to=<prefix>; repeatable) | optional |
| --note <value> | Note attached to every link added by --add/--add-glob in this invocation (embedded note= wins) | optional |
| --list | List linked files without mutating | optional |
| --append-stable | Preserve existing linked-file order and append new links without full-array resorting | optional |
| --validate-paths | Validate linked file paths for existence and file shape | optional |
| --author <value> | Mutation author | optional |
| --message <value> | History message | optional |
| --force | Force ownership override | optional |
Examples
pm item files pm-a1b2 --add "path=src/cli/main.ts,note=help orchestration"