Documentation Index
Fetch the complete documentation index at: https://notewise.click/docs/llms.txt
Use this file to discover all available pages before exploring further.
Start with commands that do not generate notes. They narrow the problem before you spend provider quota.
notewise doctor
notewise config
notewise info "https://youtu.be/VIDEO_ID"
notewise logs --tail 100
Setup and provider failures
| Symptom | Check | Fix |
|---|
| Missing API key | notewise config | Set the provider env var or rerun notewise setup. |
| Wrong model string | Command and config | Use a LiteLLM-compatible model string. |
| OAuth expired | notewise auth login ... | Re-run login in an interactive terminal. |
| Docker loses auth | Container mounts | Persist /home/notewise/.notewise. |
| Provider rate limits | Logs | Add --throttle, reduce batch size, or use another model/provider. |
YouTube failures
| Symptom | Check | Fix |
|---|
| No transcript | YouTube captions | Use another video or language. NoteWise needs transcript text. |
| Private or members-only video | Browser access | Export Netscape cookies and pass --cookie-file. |
| Playlist not resolving | notewise info URL | Use a playlist URL, watch+list URL, or supported bare playlist ID. |
| Language mismatch | Transcript language | Try --language en or another available caption language. |
Output and cache issues
| Symptom | Check | Fix |
|---|
| Output not where expected | notewise config | Check OUTPUT_DIR and --output. |
| Run skipped | Cache | Use --force to regenerate. |
| No chapter folder | Command flags | Add --chapter-directory-output; the video must have YouTube chapters. |
| Cache looks stale | notewise cache show VIDEO_ID | Prune or clear cache. Generated notes are separate files. |
| Need deeper details | Logs | Run with --verbose, then inspect notewise logs --tail 100. |
When asking for help, share command shape and redacted errors only. Do not
share API keys, OAuth tokens, cookies, raw prompts, or provider payloads.
