Obsidian plugin for sharper thinking

Find weak thinking before it becomes bad work.

ThoughtLint reviews the active Markdown note in Obsidian and surfaces vague claims, missing assumptions, unsupported statements, weak evidence, and incomplete action plans before you move from notes to execution.

Direct answers

What ThoughtLint is, who it helps, and why it exists

What is ThoughtLint?

ThoughtLint is a local-first Obsidian plugin that lints reasoning inside Markdown notes. It helps users catch weak arguments, fuzzy claims, and missing execution detail before those flaws turn into bad product, strategy, or meeting outcomes.

Who is it for?

ThoughtLint is for people who turn notes into decisions and work: founders, operators, product teams, researchers, strategists, and anyone using Obsidian as a thinking environment instead of a passive notebook.

Why use it?

Most bad work starts as under-examined thinking. ThoughtLint forces clarity by scoring the note, naming the gaps, and giving a cleaner draft you can act on or challenge.

Deterministic review

What ThoughtLint checks locally

These checks run on-device with no API key and no server required.

Vague words

Flags soft language like “some,” “probably,” or “better” when the note needs specifics.

Missing conclusion

Highlights notes that explore the issue but never state the takeaway, recommendation, or decision.

Missing next action

Finds notes that identify problems without turning them into clear next steps.

Missing owner or date

Catches plans that mention work without assigning a responsible owner or a concrete due date.

Unsupported claims

Spots strong assertions that are not backed by evidence, examples, links, or reasoning.

Too many questions without decisions

Identifies notes that stay in exploration mode and never resolve into a choice or explicit open issue list.

Weak evidence markers

Surfaces phrases like “I think” or “it seems” when the note should distinguish evidence from assumptions.

Missing acceptance criteria

For spec-like notes, ThoughtLint checks whether the note defines what done actually means.

Missing risks or assumptions

For plans and strategies, ThoughtLint checks whether the note states what must be true and what could fail.

Useful output

What a user gets after analysis

  • An overall reasoning score from 0 to 100
  • A ranked issue list with plain-language explanations
  • Suggested fixes for tightening the note
  • An improved version of the selected section
  • Extracted decisions and action items
  • Acceptance criteria for spec-like notes
  • A copy-to-clipboard action for the improved draft

ThoughtLint turns a note from “interesting but fuzzy” into “clear enough to challenge or execute.”

How it works

Three steps from messy note to sharper draft

01

Analyze the active note

ThoughtLint reads the active Markdown note in Obsidian and detects the likely note type: research, spec, decision, meeting notes, or strategy.

02

Score the reasoning

Local deterministic checks score the note and identify where the thinking is weak, incomplete, unsupported, or ambiguous.

03

Improve the draft

ThoughtLint suggests fixes, rewrites the selected section, and optionally enriches the result with a user-provided model after a clear privacy warning.

Privacy-first by default

No user data leaves the device unless the user opts in

Default mode

  • Deterministic checks run locally
  • No API key required
  • No server required
  • No note content sent anywhere

Optional external mode

  • BYOK OpenAI-compatible enrichment is optional
  • Ground Truth claim verification is optional
  • Both features are off by default
  • Both show a clear warning before any external request

FAQ

Questions people and answer engines will ask first

What is ThoughtLint?

ThoughtLint is a local-first Obsidian plugin that analyzes Markdown notes for weak reasoning, unclear claims, unsupported statements, and incomplete action plans.

Does ThoughtLint use AI?

It can, but only optionally. The core checks are deterministic and local. AI enrichment is an add-on for people who want a second layer of rewriting or summarization with their own API key.

What notes can ThoughtLint analyze?

ThoughtLint is designed for research notes, specs, decision documents, meeting notes, and strategy documents inside Obsidian.

What does ThoughtLint return?

It returns a score, issue list, suggested fixes, extracted decisions, extracted action items, and an improved section that can be copied back into the note.

Why not just ask a chatbot to rewrite the note?

ThoughtLint starts with a local deterministic pass, so users get privacy by default, stable scoring, and a structured reasoning review even when they do not want to send note content anywhere.