Memory List

goodmem memory list

List memories in a space

Synopsis

List memories in the GoodMem service, optionally filtered by labels and other criteria. Table and compact output include an IMG summary column for page-image extraction:

= unspecified P = pending P:n = pending with n extracted page images so far R = processing R:n = processing with n extracted page images so far n = completed with n extracted page images F = failed F:n = failed after producing n extracted page images Use --include-history when you need per-memory processing telemetry (this performs additional database work and is best reserved for debugging).

goodmem memory list --space-id <space-id> [flags]

Examples

  # List all memories in a space
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000

  # Filter by processing status
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --status COMPLETED

  # Filter by metadata using server-side filter expressions
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --filter "val('$.source') = 'email'"

  # Sort by different fields
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --sort-by content_type --sort-order asc
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --sort-by created_at --sort-order desc

  # Paginate through results
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --max-results 10
  # (Use the next token from the output to fetch the next page)
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --max-results 10 --next-token "ChQKEg..."

  # Combine filters and sorting
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --status COMPLETED --sort-by updated_at --sort-order desc

  # Filter by metadata labels (client-side filtering)
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --label source=user --label category=note

  # Filter by content type (client-side filtering)
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --type "application/pdf"

  # Filter by creator (client-side filtering)
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --created-by 123e4567-e89b-12d3-a456-426614174000

  # Different output formats
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --format `{json|table|compact}`

  # Get only memory IDs for scripting
  goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --quiet

	# Show full values without truncation
	goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --no-trunc

	# Include processing history in the output table
	goodmem memory list --space-id 123e4567-e89b-12d3-a456-426614174000 --include-history

Options

      --created-by string   Filter memories by creator user ID
      --filter string       Server-side metadata filter expression
  -f, --format string       Output format (json, table, or compact) (default "table")
  -h, --help                help for list
      --include-history     Include background job processing history for each memory
  -l, --label strings       Filter memories by label in key=value format (can be specified multiple times)
      --max-results int32   Maximum number of results to return
      --next-token string   Pagination token for subsequent requests
      --no-history          Do not include background job processing history for each memory
      --no-trunc            Don't truncate output values
  -q, --quiet               Output only memory IDs
      --sort-by string      Field to sort by (content_type, created_at, processing_status)
      --sort-order string   Sort direction (asc or desc)
      --space-id string     ID of the space to list memories from
      --status string       Filter by processing status (PENDING, PROCESSING, COMPLETED, FAILED)
      --type string         Filter memories by content type

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 address (gRPC API)

Memory List

goodmem memory list

Synopsis

Examples

Options

Options inherited from parent commands

SEE ALSO

On this page