ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

ACP

by debjan ST4

ACP (Agent Client Protocol) plugin for Sublime Text editor

Labels ai, agent, chat, acp

Details

Installs

  • Total 43
  • Win 21
  • Mac 9
  • Linux 13
Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6
Windows 0 1 1 0 4 0 1 1 1 1 3 0 0 0 1 1 0 2 0 1 1 3 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Mac 0 0 0 0 1 0 1 0 0 0 0 0 0 1 1 1 0 0 1 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 1 0 1 1 1 0 0 2 2 0 2 0 1 0 0 0 0 2 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

ACP - Agent Client Protocol for Sublime Text

Use AI coding agents (Kiro, Opencode, Pi, Droid, Claude Code, Copilot, …) directly from Sublime Text via the Agent Client Protocol.

screenshot

Installation

Easiest way is to install via Package Control.

For manual installation clone or copy this package into your Sublime Text Packages/ directory, then restart Sublime Text.

Quick Start

One-shot prompt

  1. Ctrl+Shift+P -> “ACP: Prompt”
  2. Pick an agent from the quick panel (skipped if only one is configured)
  3. Type your prompt in the input panel - use @ for file autocompletion, / for agent slash commands
  4. Press Enter - the response streams into a new tab

Persistent chat session (daemon)

  1. Ctrl+Shift+P -> “ACP: Session Start”
  2. Pick an agent - a spinner shows while the agent initializes
  3. Once ready, a dedicated “ACP Chat: Agent Name” tab opens
  4. Send prompts via “ACP: Prompt” - responses accumulate in the chat tab
  5. Stop the session with “ACP: Session Stop”

The daemon auto-terminates after 15 minutes of inactivity (configurable).

Switch sessions mid-session

  • Ctrl+Shift+P -> “ACP: Switch Session” - while a daemon is running, pick from the agent's recent sessions (via session/list on the live connection, filtered by the current working directory, capped by session_list_limit) and switch the daemon to it.
  • Ctrl+Shift+P -> “ACP: Session Rename” - set a title for the current session. Title is stored client-side and shown in “ACP: Switch Session”. Leave the field empty to clear it.

Walkthrough

For quick walkthrough visit walkthrough.md

Configuration

Edit ACP.sublime-settings (Preferences -> Package Settings -> ACP -> Settings):

Error: language “jsonc” is not supported
{
  // Agents you want to use
  "commands": [
    { "title": "Claude Code", "cmd": "claude-agent-acp" },
    { "title": "Opencode", "cmd": "opencode", "args": ["acp"] },
  ],

  // Quick actions (palette: ACP: Actions, sent with selected text)
  "actions": [
    { "title": "Explain", "prompt": "Explain in simple terms" },
    { "title": "Summarize", "prompt": "Summarize with key points" },
  ],

// ...

}

For available options see configuration.md.

Commands

Palette Command Keybinding Description
ACP: Prompt Alt+Shift+A One-shot prompt (or send to daemon)
ACP: Session Start Ctrl+Alt+A Start a persistent agent daemon
ACP: Session Stop Ctrl+Alt+Shift+A Terminate the running daemon
ACP: Interrupt Current Prompt Ctrl+Break Cancel the in-flight prompt (daemon only)
ACP: Actions - Run a quick action on the selected text
ACP: Session Fork - Fork the current session
ACP: Session Rename - Set a local title for the current session
ACP: Switch Mode - Change session mode mid-session
ACP: Switch Model - Change model mid-session
ACP: Switch Session - Switch the running daemon to a recent session
ACP: Switch Thought Level - Change reasoning effort mid-session

To enable keyboard shortcut open “Preferences -> Package Settings -> ACP -> Example Key Bindings”.

Switching model, mode, or thought level

While a daemon session is active, ACP: Switch Model, ACP: Switch Mode, and ACP: Switch Thought Level show a quick panel populated from the agent's advertised options. The current selection is marked with ✓. These commands are only enabled when the active agent supports the corresponding option.

Requirements

  • Sublime Text 4+ (>=4095)
  • One or more ACP-compatible agents installed

Documentation

Deeper dives live in docs/index.md: daemon architecture, permissions and the file walker, completions, and full settings reference.

License

MIT