keep list

List recent items, filter by tags, or list tag keys and values.

Usage

keep list                             # Recent items (by update time)
keep list -n 20                       # Show 20 most recent
keep list --sort accessed             # Sort by last access time
keep list .tag                        # Items with ID prefix ".tag/"
keep list .tag/act                    # Items under ".tag/act/"

Options

Argument / OptionDescription
PREFIXOptional positional — filter items by ID prefix
-n, --limit NMaximum results (default 10)
-t, --tag KEY=VALUEFilter by tag (repeatable, AND logic)
-T, --tags=List all tag keys
-T, --tags=KEYList values for a specific tag key
--sort ORDERSort by updated (default) or accessed
--since DURATIONOnly items updated since (ISO duration or date)
--until DURATIONOnly items updated before (ISO duration or date)
-H, --historyInclude archived versions
-P, --partsInclude structural parts (from analyze)
-a, --allInclude hidden system notes (IDs starting with .)
-s, --store PATHOverride store directory

Prefix filtering

keep list .tag                        # All items under ".tag/"
keep list .tag/act                    # All items under ".tag/act/"
keep list .meta                       # All contextual query definitions

Prefix queries always include hidden (dot-prefix) items.

Tag filtering

keep list --tag project=myapp         # Items with project=myapp
keep list --tag project               # Items with any 'project' tag
keep list --tag foo --tag bar         # Items with both tags (AND)
keep list --tag project --since P7D   # Combine tag filter with recency

Listing tags

The --tags option (note: different from --tag) lists tag metadata: 

keep list --tags=                     # List all distinct tag keys
keep list --tags=project              # List all values for 'project' tag

Time filtering

keep list --since P3D                 # Last 3 days
keep list --since P1W                 # Last week
keep list --since PT1H               # Last hour
keep list --since 2026-01-15         # Since specific date
keep list --until 2026-02-01         # Before specific date
keep list --since P30D --until P7D   # Between 30 and 7 days ago

Including versions and parts

keep list --history                   # Include archived versions
keep list --parts                     # Include structural parts (from analyze)

Pipe composition

keep --ids list -n 5 | xargs keep get              # Get details for recent items
keep --ids list --tag project=foo | xargs keep del  # Bulk operations

See Also