Uncertainty Markers

A Visual Studio Code extension that gives uncertainty a first-class representation in code.

Not TODOs. Not bugs.

Just honest: “I’m not fully sure about this.”

Overview

Developers are rarely allowed to leave “I don’t know” in code.

But uncertainty is real — and forgetting that you were unsure is how fragile code gets re-trusted.

Uncertainty Markers let you:

• select a line or block
• run Mark as Uncertain
• get a subtle gutter ? marker + hover message

Optional expiration keeps markers from living forever.

Key Features

• Gutter marker — subtle ? icon
• Hover note — a short explanation of what’s uncertain
• Private-by-default — stored in VS Code workspace state
• Optional expiration — never / 1 day / 7 days / 30 days / default
• Quick navigation — list all markers and jump to them

Commands

Settings

{
  "uncertaintyMarkers.enabled": true,
  "uncertaintyMarkers.defaultExpiryDays": 0
}

Use Cases

“Future me needs the truth”

You’ll see you were uncertain — before you trust it blindly.

Code reviews

Mark “copied from reference” or “edge cases unknown” without commenting noise.

Stabilization passes

Set markers to expire in 7 days so you naturally revisit them.

License

MIT License — see LICENSE.