Thought Completion

by talhabw
5
4
3
2
1
Score: 35/100

Description

This plugin has not been manually reviewed by Obsidian staff. A thinking companion that suggests what to think or write about next. Like IDE tab completion, but for thoughts.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

README file from

Github

Thought Completion

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

  1. Open Obsidian Settings → Community plugins
  2. Click "Browse" and search for "Thought Completion"
  3. Click Install, then Enable

Manual Installation

  1. Download the latest release (main.js, manifest.json, styles.css)
  2. Create a folder: <your-vault>/.obsidian/plugins/thought-completion/
  3. Copy the downloaded files into this folder
  4. 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.