# List frames to find candidates for deletionmemvid timeline myfile.mv2 --limit 100# Delete a specific framememvid delete myfile.mv2 --frame-id 42 --yes# Compact the file to reclaim spacememvid doctor myfile.mv2 --vacuum
Create a new file with larger capacity:
# Create with specific sizememvid create newfile.mv2 --size 2GB
Check current usage:
memvid stats myfile.mv2
Lock Errors
Symptom:
Error: File is locked by another process
Causes:
Another process is writing to the file
A previous process crashed without releasing the lock
Lock is held by a stale process
Solutions:
Check who holds the lock:
memvid who myfile.mv2
Request the writer to release:
memvid nudge myfile.mv2
Find the process holding the lock:
# macOS/Linuxlsof myfile.mv2
Wait and retry with timeout:
memvid put myfile.mv2 --input doc.pdf --lock-timeout 5000
Force takeover of stale lock:
memvid put myfile.mv2 --input doc.pdf --force
Only use --force if you’re certain the previous writer has crashed. Forcing a lock on an active writer can cause corruption.
# Quick verificationmemvid verify myfile.mv2# Deep verificationmemvid verify myfile.mv2 --deep
Run the doctor:
# Preview repairsmemvid doctor myfile.mv2 --plan-only# Rebuild specific indexmemvid doctor myfile.mv2 --rebuild-time-indexmemvid doctor myfile.mv2 --rebuild-lex-indexmemvid doctor myfile.mv2 --rebuild-vec-index
Verify single-file integrity:
memvid verify-single-file myfile.mv2
Time Index Issues
Symptom:
TimeIndexSortOrder: Failed in memvid verify --deepError: TimeIndexMissing
Solution:
memvid doctor myfile.mv2 --rebuild-time-indexmemvid verify myfile.mv2 --deep
# Remove existing file firstrm myfile.mv2memvid create myfile.mv2# Or use a different namememvid create myfile-v2.mv2
Diagnostic Commands
Check File Health
# Basic statsmemvid stats myfile.mv2# JSON output for scriptingmemvid stats myfile.mv2 --json# Verify integritymemvid verify myfile.mv2# Deep verificationmemvid verify myfile.mv2 --deep# Check for sidecar filesmemvid verify-single-file myfile.mv2
Inspect Lock State
# Who holds the lock?memvid who myfile.mv2# Request releasememvid nudge myfile.mv2
Doctor Commands
# Preview what would be fixedmemvid doctor myfile.mv2 --plan-only# Rebuild time indexmemvid doctor myfile.mv2 --rebuild-time-index# Rebuild lexical indexmemvid doctor myfile.mv2 --rebuild-lex-index# Rebuild vector indexmemvid doctor myfile.mv2 --rebuild-vec-index# Compact deleted framesmemvid doctor myfile.mv2 --vacuum# Fix multiple issuesmemvid doctor myfile.mv2 --rebuild-time-index --rebuild-lex-index
For large ingestion operations, you may need to increase available memory:Environment variables:
# Set model cache directoryexport MEMVID_MODELS_DIR=~/.memvid/models# Enable offline mode (skip model downloads)export MEMVID_OFFLINE=1# Control parallel ingestionexport MEMVID_PARALLEL_SEGMENTS=1
# Ingest entire directory at oncememvid put myfile.mv2 --input ./docs/
Enable parallel segments:
memvid put myfile.mv2 --input ./docs/ --parallel-segments
Skip embeddings for faster ingestion:
memvid put myfile.mv2 --input ./docs/ --no-embedding
Use vector compression for smaller files:
memvid put myfile.mv2 --input ./docs/ --vector-compression
Cleaning Up Stale Files
If you see leftover files from older versions:
# Check for sidecarsls -la myfile.mv2*# Remove any leftover filesrm -f myfile.mv2-wal myfile.mv2-shm myfile.mv2.lock# Verify clean statememvid verify-single-file myfile.mv2
Getting Help
# General helpmemvid --help# Command-specific helpmemvid create --helpmemvid put --helpmemvid find --helpmemvid doctor --help# Version infomemvid version