@builderius/sense-ai

MCP server for Claude Code that connects AI coding agents to the Builderius website builder.

Requirements

• Node.js >= 22
• Claude Code installed and authenticated

Install

npm install -g @builderius/sense-ai

Usage

Start the Builderius Sense terminal server:

sense

Options

| Flag | Default | Description | |------|---------|-------------| | --port=PORT | 7681 | Port to listen on | | --host=HOST | 127.0.0.1 | Bind address. Use 0.0.0.0 to expose to the network (Docker setups) |

sense --port=8080
sense --host=0.0.0.0
sense --host=0.0.0.0 --port=8080

Environment variables PORT and HOST are also supported.

Setup modes

Local (default)

Sense runs on the same machine as WordPress. The Builderius builder starts and manages the server automatically.

1. Install Claude Code and log in (claude login)
2. Install this package globally (npm install -g @builderius/sense-ai)
3. In Builderius settings, set Sense AI mode to Local
4. Open the builder — the Sense AI tab starts the server and connects automatically

Remote

Sense runs on your local machine while the WordPress site is hosted elsewhere (staging server, shared hosting, etc.). The builder connects to your local Sense server over the network.

1. Install Claude Code and log in on your local machine
2. Install this package globally (npm install -g @builderius/sense-ai)
3. Create a dedicated directory for the remote site and start the server from it:

   mkdir ~/my-remote-site && cd ~/my-remote-site
   sense

   Sense generates Claude Code configuration files (instructions, MCP settings, skills) in this directory. Use a separate directory per site to keep each project's context isolated.
4. In Builderius settings on the remote site, set Sense AI mode to Remote and configure the port
5. Open the builder — go to the Sense AI tab and enter the connection token
6. The server accepts the token from the first connection and saves it for future sessions

HTTPS sites: Sense auto-generates a TLS certificate so browsers can connect via wss:// from HTTPS pages. On first connection, the browser may ask you to accept the certificate — click the link shown in the builder, accept the warning, then retry.

Changing the token: If the token changes on the remote site, clear the old token in the builder and enter the new one. The server automatically accepts the updated token.

Docker / WSL2

When WordPress runs inside a Docker container (DDEV, etc.), use Remote mode. PHP inside the container cannot start processes on the host, so Local mode is not available.

By default Sense binds to 127.0.0.1, which is not reachable from inside a container. Use --host=0.0.0.0 to make it accessible:

sense --host=0.0.0.0

1. Create a dedicated directory and start Sense on the host with --host=0.0.0.0:

   mkdir ~/my-docker-site && cd ~/my-docker-site
   sense --host=0.0.0.0

2. In Builderius settings, set the mode to Remote and configure the port
3. Open the builder and enter the connection token

Note: Binding to 0.0.0.0 exposes the server to your local network. Ensure your token is strong.

Node.js version compatibility

The package compiles to V8 bytecode for performance. If you upgrade Node.js after installing, the server automatically recompiles on the next start. If auto-recompile fails, reinstall:

npm install -g @builderius/sense-ai

License

Proprietary. See LICENSE for details.