GoodMem
ReferenceCLI

Memory List

Memory List CLI command reference

goodmem memory list

List memories in a space

Synopsis

List memories in the GoodMem service, optionally filtered by labels and other criteria. 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

  # 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
  -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) (default "https://localhost:9090")

SEE ALSO