Thought Completion
talhabw98 downloadsA thinking companion that suggests what to think or write about next. Like IDE tab completion, but for thoughts.
- Overview
- Scorecard
- Updates2
A thinking companion for Obsidian that suggests what to think or write about next.
Like IDE tab completion, but for your thoughts. It shows gentle nudges at your cursor to help you develop your ideas, without writing content for you.
How It Works
As you write, the plugin analyzes your context and suggests thinking prompts like:
- "What example could illustrate this?"
- "What's the counterargument?"
- "How does this connect to [topic you mentioned]?"
- "What would need to be true for this to work?"
Suggestions appear as faded ghost text at your cursor. They help you decide what to write and think about, they don't write for you.
Features
- Ghost text suggestions — Appear inline at your cursor, styled as faded italic text
- Multiple suggestion modes:
- Auto — AI picks the best type of nudge
- Questions — Thought-provoking questions
- Structural — Organizational suggestions
- Critical — Counterpoints and challenges
- Connector — Links and connections between ideas
- Smart triggers — Suggestions appear after pauses, punctuation, or newlines
- Manual trigger — Use a command to request a suggestion anytime
- Status bar indicator — Shows current state (Idle, Queued, Thinking, Suggesting)
- Configurable — Adjust trigger delay, context size, and model parameters
Installation
From Obsidian Community Plugins
- Open Obsidian Settings → Community plugins
- Click "Browse" and search for "Thought Completion"
- Click Install, then Enable
Manual Installation
- Download the latest release (
main.js,manifest.json,styles.css) - Create a folder:
<your-vault>/.obsidian/plugins/thought-completion/ - Copy the downloaded files into this folder
- Restart Obsidian and enable the plugin in Settings → Community plugins
Configuration
Required: API Setup
This plugin requires an OpenAI-compatible API. Go to Settings → Thought Completion and configure:
| Setting | Description | Example |
|---|---|---|
| API Endpoint | Your API endpoint URL | https://api.openai.com/v1 |
| API Key | Your API key | ... |
| Model | Model name to use | gpt-4o-mini |
Compatible providers:
- OpenAI (
https://api.openai.com/v1) - OpenRouter (
https://openrouter.ai/api/v1) - Any OpenAI-compatible API (Ollama, LM Studio, etc.)
Suggestion Settings
| Setting | Default | Description |
|---|---|---|
| Mode | Auto | Type of thinking nudges (Auto, Questions, Structural, Critical, Connector) |
| Trigger delay | 2000ms | Time to wait after typing stops before suggesting |
| Trigger on punctuation | On | Suggest after sentence-ending punctuation (. ! ?) |
| Trigger on newline | On | Suggest after pressing Enter |
| Manual trigger only | Off | Only suggest when manually triggered |
Context Settings
| Setting | Default | Description |
|---|---|---|
| Context characters | 1500 | How much surrounding text to send to the AI |
| Include heading trail | On | Include current heading hierarchy for context |
Model Parameters
| Setting | Default | Description |
|---|---|---|
| Max tokens | 500 | Maximum response length. Increase for reasoning models. |
| Temperature | 0.7 | Creativity level (0 = focused, 1 = creative) |
Commands
Access these from the Command Palette (Ctrl/Cmd + P):
- Trigger suggestion — Manually request a suggestion
- Dismiss suggestion — Clear the current suggestion
- Toggle suggestions on/off — Enable/disable the plugin
- Set mode: Auto/Questions/Structural/Critical/Connector — Switch suggestion modes
Tips
For Reasoning Models
If you're using a reasoning model (like nvidia/nemotron-*), consider increasing Max tokens. These models use tokens for chain-of-thought before outputting the answer.
Privacy
- Your note content (limited by "Context characters" setting) is sent to your configured API
- API keys are stored locally in your Obsidian vault
- No data is sent anywhere except your configured API endpoint
Best Results
- Use a fast, inexpensive model for quick suggestions (e.g.,
nvidia/nemotron) - Adjust trigger delay based on your writing pace
- Try different modes to see what works for your thinking style
Development
# Install dependencies
bun install
# Build for development (watch mode)
bun run dev
# Build for production
bun run build
License
MIT License - see LICENSE for details.
Acknowledgments
Inspired by IDE code completion and the obsidian-copilot-auto-completion plugin architecture.