Troubleshooting
The five most common issues and how to fix each. Still stuck? Open an issue on GitHub.
The plugin does not appear or does not load
Run npm run build and confirm main.js, manifest.json, and styles.css are in <Vault>/.obsidian/plugins/study-agent/. Reload Obsidian, then check Settings → Community plugins for an error message.
The Model list is empty or Refresh fails
Make sure the server is running (ollama serve for local setups) and the API key and Base URL are correct, then click Refresh. A saved model that disappeared upstream shows as “name (not listed)” — pick another model or pull it with ollama pull <model>.
“Rejected the API key” or HTTP 401 from a cloud provider
Re-check the key. For Gemini, Google now issues new AQ. keys and older keys may be blocked — create a fresh key in Google AI Studio and paste it again. See the AI providers guide for per-provider notes.
The reply arrives all at once instead of streaming
Streaming was blocked (usually CORS on custom servers). The plugin already retried over the non-streaming path — the result is the same, but that path cannot be cancelled once started. Check your custom server’s CORS settings if you need streaming.
The conversation disappeared
History lives only in memory and resets when the sidebar reopens — by design. Copy any reply you want to keep (hover → copy icon) before closing the sidebar. Conversations are not saved to disk.
Thinking mode seems to do nothing with a cloud provider
Enable thinking applies to Ollama models only. Cloud providers ignore it — Claude’s extended thinking is not wired up. Switch to a local thinking model in Ollama if you want reasoning before replies.
Limitations to know
- Conversations are not saved.
- The non-streaming fallback path (
requestUrl) cannot be cancelled; the streaming path is cancellable via Stop. - Thinking mode applies to every Ollama model and message; it is ignored by cloud providers.
- The built-in study-assistant prompt is fixed; only Custom instructions are user-editable. Sampling options (temperature, max tokens) are not exposed yet.
- The selected skill is view state: it resets to None when the sidebar reopens.
Deeper help: How the agent works · Skills · AI providers · GitHub issues