GoodMemGoodMem
ReferenceCLIMemory

Memory Get

Memory Get CLI command reference

goodmem memory get

Get memory content

Synopsis

Retrieve memory content in bounded blocks. Content is sent to stdout by default. Metadata headers are included only when explicitly requested. Use --include-history when you need the background job processing history for troubleshooting. File output replaces the destination only after the download completes and its SHA-256 is verified. Requires a server supporting GetMemoryContent.

goodmem memory get <memory-id> [flags]

Examples

  # Default (stdout, content only):
  goodmem memory get 1234 > output.bin

  # Output to specified file:
  goodmem memory get 1234 --output image.jpg
  goodmem memory get 1234 -o image.jpg

  # Output file named from metadata (fallback UUID):
  goodmem memory get 1234 -O

  # Include metadata headers inline with content:
  goodmem memory get 1234 --include > memory_with_headers.bin
  goodmem memory get 1234 -i

  # Dump metadata separately:
  goodmem memory get 1234 --dump-metadata headers.txt > output.bin

  # Fetch processing history along with metadata:
  goodmem memory get 1234 --include-history --dump-metadata history.txt

Options

  -D, --dump-metadata string   Dump metadata headers to specified file
  -h, --help                   help for get
  -i, --include                Include metadata headers inline before content
      --include-history        Include background job processing history in the response
      --no-history             Do not include background job processing history in the response
  -o, --output string          Write memory content to specified file
  -O, --output-from-metadata   Use filename from metadata; fallback to memory UUID

Options inherited from parent commands

      --api-key string   API key for authentication (can also be set via GOODMEM_API_KEY environment variable)
      --server string    GoodMem server URL (gRPC API; default ports: https=443, http=80)

SEE ALSO

On this page