Skip to content

Cache Layout

By default, artifacts are written under:

~/.cache/argcomplete-snapshot/<cli-name>/

Example:

~/.cache/argcomplete-snapshot/mycli/
  snapshot-v1.json
  completion-v1.bash
  version-stamp

Files

snapshot-v1.json

Serialized snapshot of the extracted parser structure and completion metadata.

completion-v1.bash

Generated Bash completion runtime sourced by the activation bootstrap.

version-stamp

Runtime metadata used to determine whether the cache is still valid for the installed executable and schema version.

Refresh semantics

The cache is rebuilt when the runtime decides the stored signature, entrypoint, or schema no longer matches the current environment.

Use --cache-root if you need to redirect artifacts for testing or custom packaging layouts.