> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Changelog
> Product updates and improvements to Wolffish
## New features
* **Orchestrator mode.** The one agent you talk to can now become an [orchestrator](/configuration/orchestrator-mode) that spins up live parallel worker sessions on a second model, briefs and drives them, reviews their output against the goal, and folds everything into a single reply. It's opt-in and decides per turn whether to delegate — reaching for workers only when a task genuinely splits into independent parts. Single mode stays the default for quick, sequential work.
* **A "Modes" settings page.** Model setup moved to its own [Modes page](/configuration/orchestrator-mode) — the first thing you land on in Settings. Pick one model (your **Brain**) by drag-and-drop or a click; switch on orchestrator mode to add a second **Worker** model in a slot beside it.
* **Subagent transparency.** With **Verbose task results** on, each worker's text and tool calls render inline in the chat, tagged with the worker's label, so you can see exactly how the orchestrator split the work. Off — the default — shows only the final synthesized reply.
* **Greedy & Autonomy toggles.** Two behavior switches on the Modes page tune how hard the agent works on every turn, regardless of mode — **Greedy effort** (persist harder: more retries, several approaches, keep going until the job is truly done) and **Autonomy** (act with high agency, ask you as little as possible). Both off by default.
* **Run an automation now.** A **Run now** button on the [Heartbeat page](/configuration/heartbeat) fires any active scheduled job immediately, with a live overlay tracking its tool calls, results, and finish.
* **Save a file to your computer.** Save a copy of any file Wolffish has read or written — wherever it lives on your machine — to a location you choose through a normal save dialog.
## Updates
* **One Brain, no provider cascade.** The old fallback-order / priority cascade is gone. You now select one [Brain model](/configuration/providers) explicitly — the one you choose is the one that runs, and you always know which. Existing setups migrate automatically: your top provider becomes the Brain and the dead settings are cleaned out. On a transient error the same model retries on a backoff; there's no silent switch to another provider. See [config.json](/configuration/config-json) for the updated `llm` shape.
* **A default model on connect.** Connecting a provider for the first time auto-selects a sensible default model, so you're ready to go immediately — it never overrides a model you've already chosen.
* **Crash-safe writes.** Config, conversations, and channel state now write through one ordered, atomic path — temporary file, flushed to disk, then swapped into place — so a crash or hard quit can never leave a half-written, corrupted file. You always get the complete old version or the complete new one.
## New features
* **Automations.** Wolffish now manages its own scheduled jobs — its [heartbeat](/configuration/heartbeat) — entirely through conversation. Say "every morning brief me on my calendar," "in 2 days remind me to renew the lease," or "check the build every hour," and it creates the [automation](/capabilities/built-in-capabilities); ask it to list, change, delete, or test one and it does. One-time jobs fire once and remove themselves, recurring ones keep going, and jobs never overlap — one that comes due mid-run waits its turn instead of being dropped. Anything missed while the app was closed runs once, collapsed, on the next launch.
* **Read a WhatsApp chat.** A new `whatsapp_read` tool catches Wolffish up on the latest messages in any [WhatsApp](/channels/overview) contact or group, returned oldest-first. It covers traffic seen while Wolffish is connected — not older history from before it started — and that buffer now survives restarts instead of resetting every launch.
## New features
* **Ask cards.** When a decision is genuinely yours to make, Wolffish poses it as an interactive [multiple-choice card](/capabilities/built-in-capabilities) — a question, 2–5 options, and a free-text "something else" box — and waits for your pick instead of guessing. On Telegram and WhatsApp you reply with the option number.
* **Self-managed skills.** A new [`skills`](/capabilities/built-in-capabilities) capability lets Wolffish list, search, enable, disable, delete, and even **author** its own capabilities at runtime — turning "do this every time" into a reusable skill, or "turn off the browser" into a disabled one.
* **Channel status.** A new `channel_status` tool reports which messaging channels are connected and how to reconnect any that aren't.
## Updates
* **Channels aren't apps.** Asked to message you on [Telegram or WhatsApp](/channels/overview), Wolffish no longer tries to launch a phantom desktop app that doesn't exist — it reaches channels only through their own send tools and fails gracefully with reconnect steps when one is down.
* **Openable path cards.** File and folder paths Wolffish mentions in a reply now render as a card with a one-click "open in file manager" button — shown only for paths that actually exist on disk.
## Bug fixes
* **`grep -c` zero counts.** A `grep -c` that finds no matches exits with code 1 and prints "0" — that's now read as the valid zero-count it is, not a failed command, so it no longer triggers needless retries.
## New features
* **Fully local voice.** Text-to-speech now runs on [Kokoro](/capabilities/built-in-capabilities) and speech-to-text on faster-whisper — both entirely on-device, with no cloud, no API keys, and no Microsoft servers. Voice memos work fully offline after a one-time setup. The default voice is `af_bella` (English, US); voices are English-only (American `af_`/`am_`, British `bf_`/`bm_`).
* **Install voice engines on demand.** Settings → Text-to-Speech and Speech-to-Text now offer an **Install** button with a live progress bar. The voice and model pickers stay disabled until the engine is ready, and the **Preview** button plays the *actual* selected Kokoro voice — not a browser stand-in.
* **Managed Python runtime.** The voice engines provision into an isolated, app-managed Python runtime automatically — no system Python or developer tools required on the machine.
* **Z.ai (GLM) provider support.** You can now run Wolffish on [Z.ai](/configuration/zai) — Zhipu's GLM models with toggleable thinking and a 1M-token context flagship (GLM-5.2). OpenAI-compatible streaming and tool-calling at budget-tier pricing; bring your own API key.
* **Verbose task results toggle.** Each channel now has a **Verbose task results** switch — off by default — that controls how much of the agent's step-by-step work you see. Off keeps a [clean feed](/channels/overview) (replies, files, and errors only); on surfaces every tool call, result, and activity card as the turn runs.
## Updates
* **Install progress survives navigation.** Starting an install — or a Google Workspace setup/update — then switching tabs or reloading the window no longer resets the progress; it resumes exactly where the real work is.
* **One voice memo per reply.** Sending a voice note now returns exactly one voice memo across Desktop, Telegram, and WhatsApp — no duplicate memos and no echo of your own recording. Multi-step requests run normally first, then close with a single spoken reply.
* **Verbose changes display only.** Flipping the verbose toggle re-renders the feed without changing what the agent does — every tool call and result is still saved to history and memory in full, so nothing is lost when it's off.
## New features
* **Context compaction redesign.** The compaction system has been rebuilt to use instant proportional truncation plus a single LLM summary call, replacing the previous per-message approach that required N separate API calls. Compaction that took 6 minutes now completes in under 30 seconds, and a structured continuation nudge ensures the model finishes multi-step tasks after compaction instead of treating shorter context as "done."
* **Planning skill.** A built-in skill that injects planning discipline into every turn — the agent must state its understanding, lay out phases with verification criteria, and confirm each definition of done after execution.
* **Conversation timeline.** Conversations now track a timeline of key events (tool calls, results, compaction, model switches) that persists across sessions.
* **Multi-turn tool history.** Channel conversations (Telegram, WhatsApp) now reconstruct full tool-call history from stored segments, so the model can see its prior tool interactions across turns.
## Updates
* **Batch completion enforcement.** New runtime instruction ensures the agent completes every item in batch operations (e.g. reading all emails, not just a subset).
* **Structured provider error cards.** Error details now always show provider name, HTTP status, error reason, retry count, and duration — even when the API returns no error body.
* **Provider failure tracking.** Per-provider failure details are now surfaced when a stream errors mid-response, not just when all providers are exhausted.
* **Tool transcript detail logs.** A separate detail log captures full raw tool output alongside the truncated transcript preview.
## New features
* **DeepSeek provider support.** You can now run Wolffish on [DeepSeek](/configuration/deepseek), the recommended default for agentic workloads. Bring your own API key and start chatting in seconds.
* **Ollama is now optional.** You no longer need a local Ollama install to use Wolffish — pick any combination of [cloud providers](/configuration/anthropic) or [local models](/configuration/ollama) that fits your setup.
* **Microphone and audio permissions.** Wolffish now requests mic and audio access on first launch, paving the way for voice-driven workflows.
* **Instant conversation titles.** New chats get a title the moment you send your first message, so your sidebar stays organized without waiting on the model.
## Updates
* **Smarter chat rendering.** Cards, code blocks, and tool outputs now render more reliably in long conversations.
* **Refined sidebar and chat navigation.** Cleaner layout, better keyboard navigation, and quicker access to past conversations.
* **Tray menu improvements.** The system tray menu is more responsive and reflects the current app state correctly.
* **Better token display.** Token usage indicators are now accurate and easier to read at a glance.
* **Windows performance.** Shell execution and app startup have been optimized for Windows users, including a cleaner installer name.
## Bug fixes
* Fixed [web fetch](/capabilities/built-in-capabilities) failing on certain URLs.
* Fixed [channel](/channels/overview) connection errors and intermittent API failures.
* Fixed a JSON parsing crash that could interrupt long agent runs.
* Fixed microphone access on macOS.
* Fixed DeepSeek streaming and tool-call edge cases.
* Fixed [docs handling](/capabilities/built-in-capabilities) so attached files render correctly in chat.
* Fixed bypass mode not engaging in some sessions.
* Fixed blank request timeouts that could stall the agent.