Hermes Agent for VS Code

⚠️ Unofficial community extension. This is an independent third-party extension and is not affiliated with, endorsed by, or connected to Nous Research. The Hermes Agent name and logo (nous-girl.png) are property of Nous Research — used here for compatibility identification only.

An unofficial VS Code sidebar chat extension for Hermes Agent. It provides an ACP-powered conversation UI with structured thinking blocks, tool cards, editor-aware context, workspace file references, slash skills, session history, and approval modes.

Features

Sidebar chat view in the Activity Bar.
Current editor file or selection is automatically available as context unless muted.
@ workspace search for files and folders.
+ local file/folder picker.
/ skill picker from hermesAgent.skills.
Enter to send, Shift+Enter for a new line.
Session history with rename and delete.
Session title rename from the top bar.
Run settings for approval mode, model, and effort.
Streaming assistant output.
Optional Hermes CLI integration through hermesAgent.command.

Hermes CLI Integration

By default, the extension calls the local Hermes CLI:

{
  "hermesAgent.command": "hermes",
  "hermesAgent.commandArgs": ["--oneshot", "{{prompt}}"]
}

The extension composes the user prompt, selected skill, attachments, and current editor context into one text prompt, then replaces {{prompt}} in hermesAgent.commandArgs.

Anything written to stdout is appended into the assistant message. If hermesAgent.command is empty, the extension falls back to a local preview response.

Development

npm install
npm run lint
npm run package

Press F5 in VS Code to launch an Extension Development Host.

Publishing

Update publisher, repository, and version in package.json.
Run npm run package.
Publish the generated .vsix with vsce publish.

Notes

This implementation is independent of Claude Code. The Claude Code extension directory was only used as a structural reference for VS Code packaging concepts.

Hermes Agent