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-historyOptions
--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 typeOptions 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
- goodmem memory - Manage GoodMem memories