Troubleshooting
“No tasks indexed yet”
Section titled ““No tasks indexed yet””Pensum scans on startup. Run Pensum: Rescan vault from the command palette. Check the developer console (Ctrl+Shift+I) for errors.
Tasks not appearing
Section titled “Tasks not appearing”- Must use
- [ ]format (not numbered lists) - File must be
.mdin your vault - File must not be in a hidden folder
Hotkey not working
Section titled “Hotkey not working”Another plugin may have claimed it. Check Settings > Hotkeys and reassign.
Sidecar corruption
Section titled “Sidecar corruption”Delete .pensum/index.json and run Pensum: Rescan vault. No data is lost.
Sync conflicts
Section titled “Sync conflicts”Run Pensum: Rescan vault to reconcile. The sidecar uses content-hash-based reconciliation.
”Anthropic connection failed”
Section titled “”Anthropic connection failed””- Verify your key starts with
sk-ant- - Check your Anthropic dashboard for rate limits
- Verify internet connectivity
Transcription fails
Section titled “Transcription fails”- Requires an OpenAI API key (not Anthropic)
- Check the audio file exists in your Recordings folder
- Large files (>2 hours) may time out
CLI slow performance
Section titled “CLI slow performance”The CLI scans the vault on each invocation. For large vaults, a persisted sidecar is used automatically after the first full scan.
”Could not reach license server”
Section titled “”Could not reach license server””30-day offline grace period. Check your internet connection. Contact support@pensum.dev if persistent.
”Maximum devices reached”
Section titled “”Maximum devices reached””Each license allows 5 devices. Contact support@pensum.dev to reset activations.