Reflective Memory — Agent Reference Card

keep --json <cmd>        # Output as JSON (supported by most commands)
keep --ids <cmd>         # Output only IDs, one per line (for piping)
keep --full <cmd>        # Output full notes with context (overrides --ids)
keep -v <cmd>            # Enable debug logging to stderr

%a1b2c3d4         2026-01-14 URI detection should use proper scheme validation...
%e5f6a7b8         (0.89) 2026-01-14 OAuth2 token refresh pattern...
file:///path/doc  2026-01-15 Document about authentication patterns...

{"id": "...", "summary": "...", "tags": {...}, "score": 0.823}

keep find "auth" --json | ...                        # Process search results
keep list -n 5 --json | ...                          # Process recent notes

# Version history composition
diff <(keep get doc:1) <(keep get "doc:1@V{1}")      # Diff current vs previous

# Current intentions
keep now                              # Show current intentions
keep now "What's important now"       # Update intentions
keep prompt reflect                   # Structured reflection practice
keep prompt reflect "auth flow"       # Reflect with search context
keep prompt query "what do I know about auth?"  # Answer from memory context
keep prompt conversation              # Conversation analysis
keep move "name"                      # Move versions from now into named note
keep move "name" --source "other"     # Move from a different source note

# Add or update
keep put "inline text" -t topic=auth  # Text mode
keep put file:///path/to/doc.pdf      # URI mode
keep put /path/to/folder/             # Directory mode
keep put /path/to/repo/ -r            # Recursive + git changelog
keep put /path/ -r --watch            # Watch for changes
keep put /path/ -r -x "*.log"        # Recursive, excluding pattern
keep put "note" -i my-id             # Specify note ID
keep put "update" --summary "short"  # Provide explicit summary
keep put /path/ -f                   # Force re-index
keep get .ignore                      # View global ignore patterns
keep edit .ignore                     # Edit ignore patterns in $EDITOR

# Retrieve and edit
keep get ID                           # Current version
keep get ID -V 1                      # Previous version
keep get "ID@P{1}"                    # Part 1 (from analyze)
keep get ID --history                 # List all versions
keep get ID --parts                   # List structural parts
keep get ID --similar                 # Show similar notes
keep get ID --meta                    # Show metadata
keep get ID -t project=foo            # Filter by tag
keep edit ID                          # Edit content in $EDITOR
keep edit .ignore                     # Edit system docs

# Search
keep find "query"                     # Semantic search
keep find "query" --deep              # Follow tags/edges to discover related notes
keep find "query" --since P7D         # Last 7 days
keep find "query" --until 2026-01-01  # Before a date
keep find "query" --scope 'file:///path/*'  # Constrain to ID glob
keep find "query" -t project=foo      # Filter by tag
keep find "query" -a                  # Include all (no limit)
keep find --id ID                     # Find by ID

# List and filter
keep list                            # Recent notes
keep list -t project=myapp           # Filter by tag
keep list --sort created              # Sort order
keep list --since P7D --until now    # Date range
keep list --with-parts               # Only notes with parts
keep list -a                         # Include system notes
keep list "file:///"                 # Filter by ID prefix

# Remove
keep del ID                          # Remove note or revert to previous version

# Analyze (skips if parts are already current)
keep analyze ID                      # Decompose into parts (background)
keep analyze ID -t topic -t type     # With guidance tags
keep analyze ID --fg                 # Wait for completion
keep analyze ID --force              # Re-analyze even if current

# Flow
keep flow                            # Show current flow state
keep flow "state" -t target          # Transition to state
keep flow -f file.yaml               # Load flow from file
keep flow -b 10 -c cursor            # Budget and cursor control
keep flow -p key=value               # Pass parameters

# Data management
keep data export backup.json         # Export store to JSON
keep data export - | gzip > bk.gz    # Export to stdout, compress
keep data import backup.json         # Import (merge, skip existing)
keep data import backup.json -m replace  # Import (replace all)

# Maintenance
keep pending                         # Process pending tasks, tail progress
keep pending --reindex               # Re-embed all notes + process
keep pending --retry                 # Reset failed notes back to pending
keep pending --stop                  # Stop background processor

# Config
keep config                          # Show configuration
keep config "path"                   # Show specific config path
keep config --setup                  # Run interactive setup
keep config --reset-system-docs      # Reset system docs
keep config --state-diagram          # Show state diagram

from keep import Keeper
kp = Keeper()
kp.put("note", tags={"project": "myapp"})
results = kp.find("authentication", limit=5)

from keep.langchain import KeepStore, KeepNotesToolkit, KeepNotesRetriever