@blanklogic/refinery
v0.2.6
Published
Clean context before AI sees it — Refinery CLI for de-bloat and secret redaction (local, no upload).
Maintainers
Readme
@blanklogic/refinery
Local CLI that de-bloats code and redacts secrets before AI agents see them.
Use it from the terminal, in CI, or as the engine behind the VS Code extension and MCP server. No BlankLogic account required for local use.
What's new in 0.2.6
- Opt-in aggregate telemetry after each run (bytes saved, secrets redacted — never input text). Disable with
BLANKLOGIC_CLI_TELEMETRY=0.
What's new in 0.2.5
- Coordinated release —
@blanklogic/[email protected]aligned with MCP and Proxy. - Prefer Refinery web app for zero-install; CLI for pipes and CI.
- 512 KB max input · commands:
debloat,sanitize,clean.
Saved tokens or caught a secret?
If BlankLogic trimmed noise, redacted secrets, or cut token waste for you, a quick review helps others find it:
- Cursor / Open VSX: Rate BlankLogic Refinery on Open VSX
- VS Code: Leave a review on the Marketplace
- Feedback: blanklogic.io/#support
Install
npx @blanklogic/refinery clean -Global install:
npm install -g @blanklogic/refinery
refinery clean ./input.htmlQuick start
# Clean stdin (paste HTML, logs, or code, then Ctrl+D)
npx @blanklogic/refinery clean -
# Clean a file
refinery clean ./examples/sample.html
# JSON output with stats
refinery clean ./examples/sample.html --format jsonCommands
| Command | What it does |
|---------|----------------|
| refinery debloat <file\|-> | Remove tracker scripts, comments, and boilerplate |
| refinery sanitize <file\|-> | Redact obvious secrets; compact for LLM context |
| refinery clean <file\|-> | De-bloat, then sanitize (recommended) |
Stats in text mode go to stderr so stdout stays pipe-safe:
refinery sanitize .env --statsWho this is for
- Developers cleaning snippets before pasting into ChatGPT, Claude, or Cursor
- Scripts and CI gates that strip secrets from artifacts
- Power users who prefer terminal workflows over IDE extensions
Related BlankLogic tools
| Product | Link |
|---------|------|
| Web app | blanklogic.io/refinery |
| VS Code / Cursor extension | VS Marketplace · Open VSX |
| MCP server | @blanklogic/refinery-mcp |
| AI cost proxy | @blanklogic/proxy |
| Core engine | @blanklogic/refinery-core |
Cloud credits (optional)
Local CLI runs stay unlimited on your machine. When you need server-side cleanup (larger payloads, Cloud Refine, or Cloud AI), use the Refinery web app:
blanklogic.io/refinery/#cloud-credits — Beta Token Pack ($5 / 500 runs) or Founder pass ($50).
Privacy
The CLI runs entirely on your machine. It does not call Stripe, BlankLogic servers, Ollama, or third-party APIs for local commands. Cloud credits apply only to the web flow linked above.
Support
- Homepage: blanklogic.io
- Web app: blanklogic.io/refinery
- Bug reports: blanklogic.io/#bugs
