Playbooks · Coding tasks
Claude Agent ACP 0.101.0: idle compaction lands
Written November 6, 2026
Cache-aware idle compaction, single-file binaries, and background command streaming. What the protocol update changes for ACP clients.
Long agent sessions go idle, and idle sessions waste context. The Agent Client Protocol is the standard that lets an editor talk to a coding agent — the same role the Language Server Protocol plays for language servers — and the Claude agent that implements it just shipped version 0.101.0. The headline change is compaction that runs while a session sits idle, timed against the prompt cache. The rest of the release is smaller: one file to ship, a new default mode, and background output that arrives as it happens.
What 0.101.0 ships
The release notes for 0.101.0, dated November 5, list four features:
- Idle compaction: idle sessions are compacted before the prompt cache expires. A session left alone comes back smaller instead of sitting on a full context until the cache lapses. The notes tie this to the cache expiry, not to a timer the client sets.
- Single-file binaries: the agent ships as single-file executables built with Bun. One file to download and run, instead of a bundle of files.
- Auto mode by default: sessions start in Auto mode unless the client asks for something else. Previously a client had to opt in.
- Background command streaming: the output of v2 background commands streams to the client as it arrives, instead of arriving only when the command finishes.
Two fixes ride along: restored sessions now honour the configured fallback when their mode is unavailable, and the release updates the bundled Claude Agent SDK to 0.3.318.
What this is not
ACP is the protocol surface, not Claude Code itself. Version 0.101.0 is the version of the claude-agent-acp package — the agent that speaks ACP to an editor — and it is not a Claude Code release. The SDK bump mentions Claude Code 2.1.318, but that is the engine inside the agent, not the thing being released. Do not read 0.101.0 as a Claude Code version, and do not read the Auto mode default here as the Claude Code auto-mode change: they are separate releases that happen to touch the same mode name.
Nothing in the notes gives a performance figure. There is no token saving, no latency number, and no benchmark attached to idle compaction or to the single-file binaries. Any number attached to this release comes from somewhere else, not from the notes.
Who it matters for
Anyone building or running an ACP client — an editor integration, a harness that drives Claude through ACP, or a tool that keeps long sessions open. Idle compaction matters most where sessions sit open for hours: the compaction happens before the cache expires, so the session that resumes is the compacted one. Single-file binaries matter most where the agent is installed or distributed by hand. Auto mode by default matters for clients that never set a mode and took whatever the previous default was. Background streaming matters for clients that show long-running commands and previously waited for the final output.
If you only use Claude Code in a terminal, this release changes nothing you can see. It is a release for the protocol layer underneath editor integrations.
Limits
- This guide is written from the release notes. No ACP client was run here, and no idle session was compacted or measured.
- The notes do not say how much context idle compaction saves, or how long a session must sit idle before it runs. Treat both as unanswered.
- The Auto mode default applies to sessions started through this agent. A client that sets a mode explicitly is unaffected.
Related playbooks
- Claude Agent ACP 0.103: ACP v2 breaks deep imports
- Antigravity CLI 1.5.4: ACP Auto mode
- Kiro 3.1: hooks that can veto compaction
- Anthropic's no-distillation rule lands November 12
Sources
- Releases · agentclientprotocol/claude-agent-acp — GitHub release notes: 0.101.0 features and fixes
- Agent Client Protocol — protocol introduction: what ACP standardizes between editors and agents
- Run Sonnet with an Opus advisor in Claude Code — Agent Upstart: the Claude Code ecosystem this protocol layer sits under
- Run parallel subagents in Claude Code — Agent Upstart: long sessions and subagents, where idle compaction helps
- 140 silent MCP contract changes, and how to pin them — Agent Upstart: protocol changes that arrive without notice
Back to: Coding playbooks hub · Also: Run Sonnet with an Opus advisor in Claude Code · Run parallel subagents in Claude Code · 140 silent MCP contract changes, and how to pin them