Usage
Full dump
Section titled “Full dump”codeshare --fullAPI-only dump
Section titled “API-only dump”codeshare --api-only --path srcDiff since last snapshot
Section titled “Diff since last snapshot”codeshare --diff --path srcAPI-level diff
Section titled “API-level diff”codeshare --diff --diff-api-only --path srcUseful flags
Section titled “Useful flags”Restrict to code files only:
codeshare --code-onlyExclude data/ directories:
codeshare --exclude-dataIgnore lockfiles:
codeshare --ignore-lockfilesWrite to stdout only:
codeshare --stdout --no-artifactInclude imports in API-only mode:
codeshare --api-only --imports-includedInclude multiple paths:
codeshare --paths src/module_a src/module_bCompare with an older counting snapshot:
codeshare --diff --steps-back 3Compare with one exact snapshot id:
codeshare --diff --snapshot-id SNAPSHOT_IDRender read-only:
codeshare --full --read-onlyCross-repo usage
Section titled “Cross-repo usage”Explicitly provided paths may also live outside the current repository.
That is useful when assembling one share from multiple related repos, for example a code repo plus a docs repo.
Ignore policy
Section titled “Ignore policy”Use .codeignore to exclude things like docs, logs, generated files, or lockfiles when desired.