Twiddle

Prompt distillation for pi. Twiddle cleans, sharpens, and structures prompts before they reach the agent.

Not free: every optimization costs tokens. Tiny prompts can cost more than they improve. The footer shows the active mode: ~ Twiddle for manual mode and ≈ Twiddle for auto-mode.

What it does

• Translates any language into clear engineering English
• Classifies intent with fast regex rules
• Injects project context when useful
• Preserves code blocks, inline code, URLs, hashes, and semver
• Falls back through a model chain on timeout
• Skips optimization if output would exceed token budget

Quick Start

/twiddle-model
/twiddle-auto-on

~explique o padrão Repository em NestJS com exemplos

If no optimization model is configured yet, Twiddle offers the available models once per session. Selecting a model saves it and continues optimization; canceling sends prompts unchanged for the rest of the session.

Default token budget threshold is 40%.

Activation

Input	Behavior
~text	Optimize and forward
~.text	Bypass, send original
~!text	Optimize silently
~raw:text	Bypass, alias for ~.
~bug:text	Force bug_fix
~feature:text	Force new_feature
~refactor:text	Force refactor
~research:text	Force research
~test:text	Force testing
~review:text	Force review
~docs:text	Force docs
~infra:text	Force infrastructure
~design:text	Force design

Auto-mode (/twiddle-auto-on): every prompt gets distilled, unless it is a trivial greeting.

Footer

Indicator	Mode
~ Twiddle	Manual mode — use ~ to optimize a prompt
≈ Twiddle	Auto-mode — eligible prompts are optimized automatically

While optimization is running, Twiddle uses a subtle shimmer over the name. The footer does not show token savings because Twiddle is focused on clarity, translation, structure, and deduplication rather than savings accounting.

Commands

Command	Purpose
/twiddle	Show current config
/twiddle-model	Select optimization model
/twiddle-threshold [0–500]	Set token budget margin
/twiddle-timeout [5–60]	Set per-model timeout in seconds
/twiddle-fallback add|remove|list|clear	Manage fallback chain
/twiddle-verbose quiet|normal|debug	Set notification verbosity
/twiddle-auto-on	Enable auto-mode
/twiddle-auto-off	Disable auto-mode
/twiddle-report	Show session stats
/twiddle-setup	Interactive setup
/twiddle-reset	Restore defaults

Screenshots

Settings

Prompt report

How it works

1. Detect ~ input and parse override prefixes
2. Classify intent and scope
3. Inject project context when available
4. Optimize via a separate pi subprocess
5. Restore preserved fragments
6. Keep original prompt if optimization misses budget or fails

Project layout

pi-twiddle/
├── index.ts
├── optimizer.ts
├── intent.ts
├── project.ts
├── preserve.ts
├── tokenizer.ts
├── footer.ts
├── missing-model-warning.ts
├── config.ts
├── README.md
├── package.json
├── tsconfig.json
├── assets/
└── *.test.ts

Design

• Quiet by default
• No API key management
• Graceful fallback on failure
• Footer shows active mode without token-savings counters

Theme: Harpy