The cache notewise stores transcripts, video metadata, and run statistics in a local SQLite database:
~/.notewise/.notewise_cache.db
What the cache does Function Description Skip processed videos Tells the pipeline what it has already seen Stats & history stats and history commands read from itRun telemetry Token, cost, and timing records stored per run
Cache commands
notewise cache # database metadata and entry counts notewise cache --info # same as above, explicit notewise cache --show VIDEO_ID notewise cache show VIDEO_ID
notewise cache --clear # prompts for confirmation notewise cache --clear --yes # skip confirmation notewise cache clear --yes
cache --clear deletes all local processing history, transcript cache entries, and export records from the SQLite database. Generated note files on disk are not affected.
notewise cache --prune 30 # entries older than 30 days notewise cache prune --older-than 14 # entries older than 14 days
Usage statistics notewise stats # all-time totals notewise stats --model gemini/gemini-2.5-flash # filter by model notewise stats --since 7 # last 7 days notewise stats --since 30d # last 30 days
Processing history notewise history # last 10 processed videos notewise history --limit 25 # last 25
Session logs Every process run writes a structured log to:
~/.notewise/logs/notewise-YYYYMMDD-HHMMSS.log
Logs use structlog JSON format. API keys and sensitive values are automatically redacted.
View logs notewise logs # list recent log files notewise logs --tail 50 # tail the latest log (last 50 lines) notewise logs --open # open the log directory in your file manager
Clean up logs notewise logs clean # remove logs older than 7 days (default) notewise logs clean --older-than 30 # remove logs older than 30 days notewise logs clean --all # remove all inactive log files
Health check Run a non-destructive check to verify config, cache, and logs are all in order:
This checks:
~/.notewise/config.env exists and is readableSQLite cache can be opened
Log directory is writable
Configured model’s API key appears to be set
Last modified on March 28, 2026
