Back to Commands
Advancedhermes acp

hermes acp Command — Complete Reference & Examples

Complete reference for hermes acp: run Hermes as an ACP server for editor integration (VS Code, Zed, JetBrains), with setup, dependency check, and browser installation flags.

July 27, 2026

Overview

hermes acp starts Hermes Agent in ACP (Agent Communication Protocol) mode, which lets VS Code, Zed, and JetBrains IDEs delegate tasks to Hermes directly.

Usage

hermes acp [OPTIONS]

Options

Flag Description
--accept-hooks Auto-approve unseen shell hooks without a TTY prompt.
--version Print the Hermes ACP version and exit.
--check Verify ACP dependencies and adapter imports, then exit.
--setup Run the interactive provider/model setup for ACP authentication.
--setup-browser Install agent-browser and Playwright Chromium into ~/.hermes/node/ for browser tool support.
--yes, -y Accept all prompts (used by --setup-browser to skip the ~400 MB Chromium download confirmation).

Examples

# Start the ACP server (IDEs can connect to it)
hermes acp

# Verify everything is installed and importable
hermes acp --check

# Interactive setup for the model/provider used by ACP
hermes acp --setup

# Install browser support without prompting
hermes acp --setup-browser --yes

# Auto-approve shell hooks for headless/CI use
hermes acp --accept-hooks

Tips

  • Run --check before configuring an IDE extension to catch missing dependencies early.
  • --setup-browser --yes is useful in CI or containers where prompts are unavailable.
  • --accept-hooks is equivalent to HERMES_ACCEPT_HOOKS=1 or hooks_auto_accept: true in config.yaml.

See also

hermes setup, hermes model, hermes auth, hermes tools.

Explore All Commands

Browse the full command reference with search and category filters.

Back to Commands