Skip to main content

​
The cache

notewise stores transcripts, video metadata, and run statistics in a local SQLite database: 
~/.notewise/.notewise_cache.db

​
What the cache does

FunctionDescription
Skip processed videosTells the pipeline what it has already seen
Stats & historystats and history commands read from it
Run telemetryToken, cost, and timing records stored per run

​
Cache commands

Inspect

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: 
notewise doctor
This checks:
  • ~/.notewise/config.env exists and is readable
  • SQLite cache can be opened
  • Log directory is writable
  • Configured model’s API key appears to be set