Skip to content

ACP Plugin ​

Help query: "What does the acp plugin do?" / "How do I use acp in Volt?" / "How do I open the ACP dock?" / "How do ACP Subagents work?" / "How do I see ACP session capabilities?" / "How do Cursor CLI ACP methods work?"

The acp plugin integrates Agent Client Protocol clients into Volt. It manages client/session/model/mode pickers, permission approve/deny, an ACP buffer with plan/output panes, ACP Subagent regions inside the parent buffer, and an ACP dock for switching root sessions. ACP helper processes are Owned Processes tied to workspace lifetime.

Package nameacp
Moduleuser/acp.rs

What it does ​

  • Pick and connect ACP clients configured in user config
  • Create sessions and switch modes/models
  • Switch focus between plan and output panes
  • Handle permission prompts (approve/deny)
  • Provide dock navigation and input focus helpers
  • Multiplex ACP Subagents (subagent_update) as collapsible regions inside the parent ACP buffer
  • Advertise clientCapabilities.subagents so agents can create ACP Subagents
  • Show ACP agent and session capabilities (acp.capabilities or /capabilities)
  • Handle Cursor CLI extension methods (cursor/ask_question, cursor/create_plan, cursor/update_todos, cursor/task, cursor/generate_image)

ACP Subagents ​

When an agent creates an ACP Subagent, Volt keeps that work in the parent ACP buffer and one ACP Dock row. Each ACP Subagent uses its own session id on the same connection. Those ids render as collapsible regions in the parent buffer. v1 supports render, region navigation and fold, permission attribution, load and replay into the parent, and cancel. There is no separate prompt surface for an ACP Subagent. Cancel applies to the current ACP Subagent only when that association advertises cancel. Otherwise acp.cancel cancels the root session.

When an ACP client is connected and an ACP buffer is focused, the modeline shows the sticky current ACP Subagent title as sub:{title}. If that buffer has ACP Subagents in Running or RequiresAction, it also shows ×{count} in the muted modeline token.

Commands ​

CommandDescription
acp.pick-clientOpens the ACP client picker.
acp.pick-sessionOpens the ACP session picker for the active client.
acp.new-sessionCreates a new ACP session for the active client in a new buffer.
acp.pick-modeOpens the ACP mode picker for the active session.
acp.pick-modelOpens the ACP model picker for the active session.
acp.cycle-modeCycles to the next ACP session mode.
acp.switch-paneSwitches focus between the ACP plan and output panes.
acp.complete-slashOpens ACP slash command completion.
acp.focus-inputFocuses the ACP input section and enters insert mode.
acp.disconnectDisconnects the active ACP client.
acp.permission-approveApproves the latest ACP permission request.
acp.permission-denyDenies the latest ACP permission request.
acp.dock.toggleShows or hides the ACP dock for the active workspace.
acp.dock.previousMoves to the previous ACP buffer in the dock list.
acp.dock.nextMoves to the next ACP buffer in the dock list.
acp.subagent.nextSelects the next ACP Subagent region in the active buffer.
acp.subagent.previousSelects the previous ACP Subagent region in the active buffer.
acp.subagent.toggle-foldToggles fold for the current ACP Subagent region.
acp.cancelCancels the current ACP Subagent when cancel-capable, otherwise the root session.
acp.capabilitiesShows ACP agent and session capabilities for the active ACP buffer.

Keybindings ​

ChordCommandScope
Shift+Tabacp.cycle-modeGlobal (Insert)
Ctrl+Tabacp.switch-paneWorkspace
Ctrl+macp.pick-modelWorkspace (Normal)
Ctrl+sacp.pick-sessionWorkspace (Normal)
Ctrl+xacp.cancelWorkspace
j / kacp.dock.next / previousAcpDock
Iacp.focus-inputWorkspace (Normal) on ACP buffer
]acp.subagent.nextWorkspace (Normal) on ACP buffer
[acp.subagent.previousWorkspace (Normal) on ACP buffer
zaacp.subagent.toggle-foldWorkspace (Normal) on ACP buffer

Session capabilities ​

acp.capabilities focuses the ACP buffer even when another buffer is active, switches to the Output pane, scrolls to the report, and writes a one-line summary in the ACP footer (client: … · protocol: … · agent: …).

In the ACP prompt, /capabilities and the text acp.capabilities are local commands, the same as /clear. Volt handles them and does not send them to the agent. /clear starts a new ACP session.

If no session is connected, the output and the footer say ACP session is not connected.

System messages in the ACP transcript use the default text color.

Cursor CLI methods ​

Volt's ACP client handles Cursor CLI ACP extension methods on the connection. Standard ACP subagent_update still creates ACP Subagents. These cursor/ methods are extra. Shipped client entries in user/config/acp.yaml stay the same, and no new acp.* commands are added.

cursor/ask_question blocks until the picker finishes. Volt opens one picker per question. The picker title is the request title plus the question prompt. Rows are the options plus Skip. Enter sends one selected option id. After the last question, Volt replies outcome answered. Skip replies outcome skipped and stops the remaining questions. Escape replies outcome cancelled so the agent unblocks. When allowMultiple is true, the picker detail notes that, and the picker still sends one option id.

cursor/create_plan blocks until the picker finishes. Volt writes a system message in Output from the plan name, overview, and plan markdown, with a blank line between the parts that are present. Todos land in the Plan pane and replace the current plan. Phase todos are included and prefixed with the phase name. The picker rows are Accept plan and Reject plan. Accept replies outcome accepted. Reject replies outcome rejected. Escape replies outcome cancelled.

cursor/update_todos updates the Plan pane. merge: true replaces entries with the same todo id (cursorTodoId) and adds ids that are not already in the plan. merge: false replaces the whole plan. A missing merge value replaces the whole plan. Status pending stays pending, in_progress becomes in progress, and completed and cancelled become completed.

cursor/task opens an ACP Subagent region in the parent buffer. The region id is cursor:{agentId} when an agent id is present, otherwise cursor:{toolCallId}. The header is the task description. The subtitle is the subagent type: a string, or the custom name when the type is {custom: name}. The prompt is a system message inside the region. When durationMs is present the region is idle and collapsed. When durationMs is absent the region stays running and expanded. The region is not cancel-capable. Ctrl+x still cancels the root session.

cursor/generate_image writes a system message Generated image: {description} ({path}). When the path is missing, the message is Generated image: {description}.

Cursor documents cursor/update_todos, cursor/task, and cursor/generate_image as notifications. Cursor often sends them as JSON-RPC requests. Volt handles both ext_method and ext_notification. On the request form Volt replies immediately (accepted, completed, or generated) so the agent does not wait. Unknown extension methods return JSON null.

Notes ​

Client list comes from user/config/acp.yaml (via config.yaml). Buffer kind is acp. Only root sessions appear in the ACP Dock. ACP Subagent session ids stay in the parent buffer. Many ACP Subagent session ids can map to one parent ACP buffer.

Volt uses a fork of ACP schema 0.11.4 that adds subagent_update, session messages, and clientCapabilities.subagents. The connection SDK stays on 0.10.

Volt — modal editor platform · docs optimized for in-editor help search