Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/AUAggy/deslop

Rewrites AI-generated prose into clear technical writing. Removes slop vocabulary, padding phrases, decorative emojis, and cliche structures from READMEs, docstrings, commit messages, and blog posts. Works with OpenRouter and Venice.ai. Any model, your API key.
https://github.com/AUAggy/deslop

ai-tools ai-writing chatgpt developer-tools documentation grok llm markdown open-vsx openrouter productivity prose readme rewrite technical-writing text-editor venice-ai vscode-extension vscodium writing-tools

Last synced: 5 days ago
JSON representation

Rewrites AI-generated prose into clear technical writing. Removes slop vocabulary, padding phrases, decorative emojis, and cliche structures from READMEs, docstrings, commit messages, and blog posts. Works with OpenRouter and Venice.ai. Any model, your API key.

Awesome Lists containing this project

README 

          


  DeSlop




DeSlop





  VS Code Marketplace

  Open VSX

  GitHub Release

  MIT License






  Install •

  What it does •

  What it removes •

  Settings •

  Privacy




---



Your AI assistant writes documentation the way a nervous intern writes a performance review: inflated, hedged, and padded with words that sound important but carry no information. "Leverage synergies." "Foster innovation." "Seamlessly facilitate a paradigm shift."



DeSlop fixes that. Select the text, run the command, review the diff, accept or discard. The result reads like a person wrote it, specifically a person who knows what they are talking about and has no patience for filler.





  DeSlop before and after comparison




---



## What it does



DeSlop sends your selected prose to an AI model with a strict ruleset that bans the exact patterns AI models produce. It returns a rewrite and a structured list of every change made and why. You review the diff in VS Code's native diff view, then click Accept or Discard in the status bar at your own pace.



It does not generate new content. It does not check grammar. It rewrites what you already wrote, or what your AI assistant wrote for you, to meet a higher standard.



---



## Features



- **DeSlop Selection**: one command, available in the command palette and right-click context menu

- **Four document types**: README, Docstring/Comment, Commit Message, Blog/Article. Each applies a different set of style constraints.

- **Smart doc type inference**: when you select a comment or docstring in a source file, DeSlop skips the prompt and applies the Docstring/Comment rules automatically.

- **Full docstring support**: Python `"""` and `'''` blocks, PowerShell `<# ... #>` blocks, JSDoc, `//` comments, and language-aware `#` comments. Interior lines of multi-line docstrings are handled correctly.

- **Code region preservation**: content inside triple-backtick fences, inline code spans, and YAML frontmatter is never modified, regardless of what surrounds it.

- **Diff view**: side-by-side comparison before any text is changed

- **Status bar Accept/Discard**: persistent buttons so you can read the full diff before deciding

- **Changes panel**: structured list of every rule violated, shown in the Output panel after each accepted rewrite

- **Status bar indicator**: shows inference is running; disappears when done

- **Configurable model**: defaults to DeepSeek V4 Flash on both providers; swap to any model you trust



---



## What it removes



**Banned vocabulary** -- words that appear in AI output at rates that would embarrass a thesaurus:



`delve` `leverage` `tapestry` `spearhead` `paradigm shift` `robust` `seamless` `synergy` `ecosystem` `holistic` `scalable` `utilize` `facilitate` `empower` `disruptive` `groundbreaking` `transformative` `innovative` `cutting-edge` `orchestrate` `curate` `cultivate` `democratize` `reimagine` `unleash` `harness` `supercharge` `north star` `mission-critical` `best-in-class` `thought leadership` `low-hanging fruit` `move the needle` `circle back` `double-click` `learnings` and 40 more



**Padding phrases** -- sentences that exist to delay the actual point:



`"it's worth noting"` `"essentially"` `"needless to say"` `"without further ado"` `"as you may know"` `"feel free to"` `"I'm excited to share"` `"as per"` and more



**Cliche structures** -- formats that signal AI authorship before the reader reads a word:



- `Question? Answer.` sentence pairs

- `"In a world where..."` openers

- `"This isn't X. It's Y."` contrasts

- `"Whether you're a X or a Y..."` appeals

- `"The future of X is here"`

- Anthropomorphism applied to code



**Decorative emojis** -- the ones that add energy but no information:



🚀 ✨ 🔥 ⚡ ✅ 🙌 💎 👉 🧠 ⭐ 🎉 🌍 📈 📣 🔒 🪄 🧵



**Smart typography** introduced silently by LLMs: curly quotes `"` `"`, em-dashes `--`, en-dashes `-`, and ellipses `...` replaced with their plain equivalents.



---



## Requirements



An API key from one of the supported providers:



**OpenRouter** (default): aggregates dozens of models under one key, including Grok, Claude, GPT, Llama, and more. No separate provider accounts required. Get a key at [openrouter.ai/keys](https://openrouter.ai/keys).



**Venice**: privacy-focused inference. No data retention. Get a key at [venice.ai/settings/api](https://venice.ai/settings/api).



The extension asks for a key on first use and stores it in your OS keychain via VS Code SecretStorage. It is never written to any file. Each provider stores its key separately; switching providers prompts for a new key if none is saved for that provider.



---



## Getting started



**VS Code:** Search "DeSlop" in the Extensions panel, or install from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=AUAggy.deslop).



**VSCodium:** Search "DeSlop" in the Extensions panel (pulls from Open VSX Registry), or install from [Open VSX](https://open-vsx.org/extension/AUAggy/deslop).



**Manual install:** Download the `.vsix` from the [latest GitHub release](https://github.com/AUAggy/deslop/releases), then run `Extensions: Install from VSIX` from the command palette.



Then:

1. Run **DeSlop Selection** from the command palette

2. Paste your API key when prompted

3. Select text, run the command, pick a document type, review the diff



---



## Commands



| Command | ID |

|---|---|

| DeSlop Selection | `deslop.humanizeSelection` |



Available in the command palette and the editor right-click context menu when text is selected.



---



## Settings



| Setting | Type | Default | Description |

|---|---|---|---|

| `deslop.provider` | enum | `openrouter` | `openrouter` or `venice` |

| `deslop.model` | string | `deepseek/deepseek-v4-flash` | Model ID for the selected provider |

| `deslop.defaultDocumentType` | enum | `null` | Pre-select doc type; null means always prompt |

| `deslop.showChangeLog` | boolean | `true` | Show changes panel after each accepted rewrite. User-scope only. |

| `deslop.autoAccept` | boolean | `false` | Skip diff view and apply immediately. User-scope only. |



**Model IDs by provider:**

- OpenRouter: `deepseek/deepseek-v4-flash`, `anthropic/claude-sonnet-4.6`, `openai/gpt-5.5`, and [hundreds more](https://openrouter.ai/models)

- Venice: `deepseek-v4-flash`, `claude-sonnet-4-6`, `kimi-k2-6`, and [more](https://docs.venice.ai/models/overview)



---



## Privacy



Text submitted for rewriting goes to your chosen provider under your own API key. The extension does not store, log, or cache it. The provider's data retention policies apply.



The API key lives in your OS keychain. It does not appear in `settings.json`, logs, or anywhere a grep would find it.



---



## Limitations



- Rewrites prose only. Code selections are rejected.

- Maximum selection: approximately 3,000 words.

- One command. No file-level rewrites, no inline triggers, no sidebar.

- Requires an internet connection and an API key.



---



## License



MIT -- [Miaggy.com](https://miaggy.com)