Forem: Jun Han

OpenClaw is old? Run Hermes Agent in VS Code through ACP (Agent Client Protocol) now!

Jun Han — Sun, 19 Apr 2026 08:49:21 +0000

In recent weeks, the Hermes Agent becomes much populor in Agent world.

Several users asked me about whether my VS Code ACP Client extension could support Hermes Agent?

So in this weekend, I have added support for Hermes Agent!

Please note that, before you could run Hermes Agent in VS Code, install Hermes Agent via the Hermes Quickstart (Linux/macOS/WSL2 only — Windows requires WSL2). Make sure hermes is on your PATH and launch VS Code from the same shell/venv. Configure credentials with hermes model.

If you are a Windows user, you need to connect to the Hermes Agent in WSL through the WSL VS Code extension:

Actually, I've quietly developed three different ACP Clients that can suit different user groups!

If you're a VS Code user, try the ACP Client extension:

https://github.com/formulahendry/vscode-acp

If you want a lightweight ACP Desktop interface on Windows/macOS/Linux, check out the cross-platform ACP UI:

https://github.com/formulahendry/acp-ui

If you want to connect to an Agent from your phone via WeChat (iOS or Android), go for WeChat ACP:

https://github.com/formulahendry/wechat-acp

There’s something for everyone!

Connect to any Agent, anytime, anywhere — effortlessly.

Connect WeChat to Claude, Codex, Copilot, Qwen, Gemini, OpenCode through ACP (Agent Client Protocol)

Jun Han — Tue, 24 Mar 2026 01:32:13 +0000

Recently, WeChat officially announced support for OpenClaw.

I dug into the source code. Turns out the backend is built on the iLink API for messaging.

The endpoint is ilinkai.weixin.qq.com, and it uses a REST API.

What if I build a WeChat Bridge that connects to any ACP agent?

I started hacking immediately last night.

Here it is!

🚀 Release: `wechat-acp`

https://www.npmjs.com/package/wechat-acp

Run one command:

npx -y wechat-acp@latest --agent copilot

Scan the QR code with WeChat, and you can control Copilot CLI directly from WeChat.

It also ships with other mainstream agents:

npx -y wechat-acp@latest agents

Or start any custom ACP agent:

npx -y wechat-acp@latest --agent "npx my-agent --acp"

The code is fully open-source:

https://github.com/formulahendry/wechat-acp

Feel free to try it out or just take a look!

Run OpenClaw in VS Code through ACP (Agent Client Protocol)

Jun Han — Sun, 01 Mar 2026 09:32:57 +0000

Just a few days ago, OpenClaw received a significant update.

OpenClaw 2026.2.26 Update Highlights:

ACP Agents as first-class runtimes
Android support
Major security fixes

The big news is that OpenClaw has elevated ACP Agents to first-class runtimes. This means OpenClaw can now function as an ACP Client, connecting to any ACP Agent.

Interestingly, this capability isn't entirely new. Back in January, OpenClaw itself could already act as an ACP Agent, allowing it to be connected by any other ACP Client.

Today, I had a thought: wouldn't it be even more convenient to connect to OpenClaw directly from VS Code?

So, I immediately updated my VS Code ACP Client extension to add support for OpenClaw!

Important Compatibility Note

The latest version of OpenClaw as an ACP Agent seems to have some bugs. I found that using OpenClaw v2026.1.30 works flawlessly, with smooth, responsive operation.

npm i -g openclaw@2026.1.30

Setup

To make OpenClaw run in VS Code, you need to run openclaw onboard in your terminal to setup the OpenClaw.

More details: https://docs.openclaw.ai/start/onboarding-overview

Supported Agents

The ACP Client extension currently supports nine major Agents by default:

GitHub Copilot
Claude Code
Gemini CLI
Qwen Code
OpenCode
Codex CLI
Qoder CLI
Auggie CLI
OpenClaw

You can also configure it to connect to additional ACP Agents.

Open Source

Both my two projects are fully open source:

VS Code ACP Client Extension: GitHub Link
ACP UI: GitHub Link

Give it a try and let me know your experience! The integration brings us one step closer to seamless AI assistant workflows within our development environment.

VS Code ACP Client extension: conect to Claude, Gemini, Codex, OpenCode, Qwen Code and so on

Jun Han — Thu, 12 Feb 2026 03:04:41 +0000

The Agent Client Protocol (ACP) standardizes communication between code editors/IDEs and coding agents.

Similar to how the Language Server Protocol (LSP) standardized language server integration. Agents that implement ACP work with any compatible editor. Editors that support ACP gain access to the entire ecosystem of ACP-compatible agents.

Last month, I used Tauri to build a modern, cross-platform desktop client for the Agent Client Protocol (ACP):

https://github.com/formulahendry/acp-ui

Then, I feel that it would be much useful if we could use VS Code as an ACP Client, leveraging the power of VS Code File System APIs and Terminal APIs, to provide native coding experiece.

Thus, I build an ACP Client extension for VS Code:

https://github.com/formulahendry/vscode-acp

Core Features

Multi-Agent Support: Connect to 8 pre-configured ACP agents or add your own
Single-Agent Focus: One agent active at a time — seamlessly switch between agents
Interactive Chat: Built-in chat panel with Markdown rendering, inline tool call display, and collapsible tool sections
Mode & Model Picker: Switch agent modes and models directly from the chat toolbar
File System Integration: Agents can read and write files in your workspace
Terminal Execution: Agents can run commands with terminal output display
Permission Management: Configurable auto-approve policies for agent actions
Protocol Traffic Logging: Inspect all ACP JSON-RPC messages with request/response/notification labels
Agent Registry: Browse and discover available ACP agents

Out of box, you could connect to GitHub Copilot, Claude Code, Gemini CLI, Qwen Code, OpenCode, Codex CLI, Qoder CLI and Auggie CLI.

In addition, you could easily config to connect to any ACP-compatible AI coding agent directly from VS Code.

The repo is fully open-source: https://github.com/formulahendry/vscode-acp

Welcome to install and have a try!

Goodbye, Vibe Coding! Hello, Spec-Driven Development MCP Server!

Jun Han — Tue, 29 Jul 2025 11:54:32 +0000

Recently, we can see a shift from Vibe Coding to Spec Driven and Context Engineering. The pursuit isn't just about fast PoCs, but also about stable Production Readiness.

I believe many of us have had similar experiences. Vibe Coding was very fast when building a PoC project. However, as the project complexity increased, various problems emerged:

The code generated by rapid iteration lacks sufficient documentation, unit testing, or architectural constraints, which can easily lead to technical debt.
Developers may not fully understand the generated code, and face great difficulties when debugging, modifying or extending the functionality, making it difficult to maintain and expand.
etc.

The emergence of Spec-Driven Development can solve the above problems well.

So, what is the difference between the two?

Vibe Coding: Prompt → Code
Spec-Driven Development: Prompt → Requirements → Design → Tasks → Code

By prioritizing requirements documentation, system design, and task lists, we ensure that code logic is clear and aligned with business goals. This improves project maintainability and reduces subsequent technical debt. This is also helpful for team collaboration on large, complex projects!

How do we use Spec-Driven Development in our daily development?

So, I developed the Spec-Driven Development MCP Server:

https://www.npmjs.com/package/mcp-server-spec-driven-development

The current v0.1 version provides three predefined prompts:

In VS Code GitHub Copilot, you can use /mcp to trigger it:

Usage

Take developing a Vue.js TODO App as an example, it can be done in a few minutes!

Generate requirements document (requirements.md) using generate-requirements
Generate system design document (design.md) using generate-design-from-requirements
Generate code using generate-code-from-design

Finally, it is running!

The code is completely open source, welcome to star:

https://github.com/formulahendry/mcp-server-spec-driven-development

Bundle MCP Server into VS Code extension

Jun Han — Thu, 01 May 2025 02:06:48 +0000

If you are building MCP Server with Node.js, then you could bundle it into VS Code extension.

Why

You would ask why we need to do this?

There would be 3 benefits:

Zero setup for end users to install MCP Server
No extra toolchain is needed for users to install. User do not even need to install Node.js, since the MCP Server is running as part of VS Code extension in Extension Host process.
Total bundle size is small. In my Code Runner MCP Server extension, just 4 MB size in total.

How

Just 3 steps are needed!.

1) In your Node.js MCP Server, expose an API to start as Streamable Http MCP Server:

export async function startMcpServer(transport: Transport, options?: HttpServerOptions): Promise<void | McpServerEndpoint> {
    if (transport === 'stdio') {
        return startStdioMcpServer();
    } else if (transport === 'http') {
        return startStreamableHttpMcpServer(options?.port);
    } else {
        throw new Error('Invalid transport. Must be either "stdio" or "http"');
    }
}

2) In your VS Code extension, reference your MCP Server npm and start Streamable Http MCP Server, then you will get a localhost MCP Server URL:

import { startMcpServer } from "mcp-server-code-runner";

async function startHttpMcpServer(): Promise<string | undefined> {
    const result = await startMcpServer("http", { port: 3098 });

    return result ? result.url : undefined;
}

3) In your VS Code extension, update the endpoint of Streamable HTTP MCP Server into VS Code settings.json:

async function updateMcpUrlToVsCodeSettings(mcpUrl: string) {
    const configuration = vscode.workspace.getConfiguration();
    const mcpServers = configuration.get<any>("mcp.servers", {});
    mcpServers["code-runner-streamable-http-mcp-server"] = {
        type: "http",
        url: mcpUrl,
    };
    await configuration.update("mcp.servers", mcpServers, vscode.ConfigurationTarget.Global);
}

Check out the full source code here:

MCP Server: https://github.com/formulahendry/mcp-server-code-runner
VS Code extension: https://github.com/formulahendry/vscode-code-runner-mcp-server

And welcome to try the Code Runner MCP Server VS Code extension directly:
https://marketplace.visualstudio.com/items?itemName=formulahendry.code-runner-mcp-server

Code Runner MCP Server is coming, supports 39 Programming Languages!

Jun Han — Fri, 28 Mar 2025 09:30:36 +0000

You may know that I developed a Code Runner VS Code extension with over 70 million downloads: https://marketplace.visualstudio.com/items?itemName=formulahendry.code-runner

So, if we take the code execution feature of Code Runner and turn it into an MCP Server, wouldn't that be super powerful?

On night, I decided to go for it!

Design, develop, debug, test, and release — all in one go!

I released the Code Runner MCP Server:

https://www.npmjs.com/package/mcp-server-code-runner

Because it supports running multiple programming languages, you can even use mainstream languages like Python or JavaScript to interact with the Code Runner MCP Server, making it a flexible and powerful Computer Use tool!

This tool can do anything!

For example, you can query the CPU information of the current OS:

Or check the latest MSFT stock price:

Or take a screenshot of the current window and save it locally:

In the examples above, when a pip package isn't installed, the GH Copilot Agent can even help install it automatically, completing the screenshot task in the end!

Simple, but it just works!

Anything that Python or JavaScript can do, the Code Runner MCP Server can do too!

You can use the Code Runner MCP Server on any client that supports the MCP protocol: VS Code, Cursor, Windsurf, Claude Desktop, etc. (Note: VS Code needs to be the latest Insider version.)

Supported Programming Languages

JavaScript
PHP
Python
Perl
Perl 6
Ruby
Go
Lua
Groovy
PowerShell
BAT/CMD
BASH/SH
F# Script
C# Script
VBScript
TypeScript
CoffeeScript
Scala
Swift
Julia
Crystal
OCaml Script
R
AppleScript
Elixir
Clojure
Racket
Scheme
AutoHotkey
AutoIt
Kotlin Script
Dart
Haskell
Ni
Lisp
Kit
V
SCSS
Sass

Currently, the Code Runner MCP Server only supports stdio. In the future, after supporting SSE, it could even run remotely!

Let me know if you have any feedback!

Last but not least, it is fully open source:
https://github.com/formulahendry/mcp-server-code-runner/

Create your own MCP Server from scratch!

Jun Han — Wed, 26 Mar 2025 10:51:14 +0000

Recently, MCP (Model Context Protocol) has been gaining popularity in the field of AI development!

A few days ago, I also developed a Code Runner MCP Server:

https://github.com/formulahendry/mcp-server-code-runner

It supports running multiple programming languages: JavaScript, PHP, Python, Perl, Perl 6, Ruby, Go, Lua, Groovy, PowerShell, BAT/CMD, BASH/SH, F# Script, C# Script, VBScript, TypeScript, CoffeeScript, Scala, Swift, Julia, Crystal, OCaml Script, R, AppleScript, Elixir, Clojure, Racket, Scheme, AutoHotkey, AutoIt, Kotlin Script, Dart, Haskell, Ni, Lisp, Kit, V, SCSS, Sass.

Today, I’ll share my experience of developing the MCP Server and some pitfalls I encountered along the way.

Using Node.js as an example, let's see how we could develop your own MCP Server from scratch!

1. Install Node.js

Visit https://nodejs.org/en and install the LTS version of Node.js.

2. Install the Scaffolding Tool

Run the following command in the terminal to install the Yeoman Generator for MCP Server:

npm install -g yo generator-mcp

3. Create an MCP Server Project

Run the following command in the terminal to create your MCP Server project:

yo mcp -n 'Weather MCP Server'

4. Implement the Code Logic

The generator-mcp has already generated and installed all the necessary code frameworks and dependencies.

You can modify the code as needed or directly debug and test using the existing code.

5. Debug/Testing

The generator-mcp has already configured the debug files for VS Code: launch.json and tasks.json.

Open the project in VS Code and press F5 to start debugging with just one click!

Wait a moment, and once the MCP Inspector opens automatically in your browser, you can start testing!

6. Running

Additionally, you can test your MCP Server in other clients that support MCP.

The generator-mcp has already created the .vscode\mcp.json file by default, which defines how the MCP Server runs in VS Code.

Note: You need to download the latest version of VS Code Insiders from https://code.visualstudio.com/insiders/.

Once you’ve installed the latest version of VS Code Insiders, click the “start” button, and your MCP Server will be called in the Agent Mode of VS Code Insiders!

7. Publishing

After completing the testing, you can publish your MCP Server to the npm registry or Docker Hub!

For details on how to write the Dockerfile, how to configure the MCP Server in clients like VS Code and Claude Desktop, and issues that may occur with npx on Windows, you can refer to the Code Runner MCP Server’s README and source code. It’s fully open-source: