VibeHard MCP Server.

The VibeHard Agent Edition is an MCP server: your agent connects to it over the standard tool protocol and drives the factory.

Setup

curl -fsSL https://vibehard.ai/download/install-agent.sh | bash

Then add the server to your agent’s MCP config, or let the installer register it:

{
  "mcpServers": {
    "vibehard-agent": {
      "command": "/Users/you/.local/bin/vibehard-agent",
      "args": ["mcp"]
    }
  }
}

Use the absolute path the installer prints (for example /Users/you/.local/bin/vibehard-agent on a Mac or /home/you/.local/bin/vibehard-agent on Linux); MCP clients do not expand ~. The installer writes this same entry, named vibehard-agent, when you agree at the prompt or pass --mcp-register.

It runs over standard input and output on your machine. No API key is needed for the Community Edition.

Tools exposed (16)

  • — vibehard_session_open / vibehard_session_close: Open and close a session with the factory.
  • — vibehard_build_start: Submit a software request. The factory runs the pipeline and hands the reasoning steps to your agent as work orders.
  • — vibehard_workflow_brief: Prepare a workflow brief or evidence bundle locally on your machine. Hosted workflows are coming soon.
  • — vibehard_task_next / vibehard_task_submit: Fetch the next work order and return your agent’s result; the pipeline resumes.
  • — vibehard_review_next / vibehard_review_respond: See the next open human checkpoint and record the answer.
  • — vibehard_status / vibehard_progress: Check a job’s status, or get a plain-English progress report.
  • — vibehard_gate: Run the verification chain on a folder as a background job.
  • — vibehard_deploy: Run the chain and, only if it passes, write the sealed pass marker.
  • — vibehard_snapshot / vibehard_rollback: Take a labeled snapshot, or roll the workspace back to one. A safety snapshot is taken first, and untracked files are set aside, not deleted. Rollback needs a target and a reason, is limited to two per job, and may use one repair attempt.
  • — vibehard_handoff: Generate the handoff package for a finished job: the as-built report and a maintainer runbook.
  • — vibehard_install_info: Get install instructions and download details for your edition and platform.

Under the hood

  • — Your agent does all the reasoning. The factory issues work orders and checks every result, and a network guard in the daemon blocks calls to AI model providers.
  • — Results are checked by the 44-gate chain. Only a full pass writes the sealed pass marker, which is bound to the project files and to the set of gates that ran.
  • — Human checkpoints (questions, scope review, plan approval) are recorded. On the strictest setting, sensitive questions must be answered by a person.

Full documentation

Documentation ยท llms.txt for agents.

Install by operating system

Temporary: until the installer handles prerequisites itself, run the block for your system. Agents: run uname -s first (Darwin = macOS, Linux = Linux; on Windows, check whether you are inside WSL) and use the matching block.

macOS (Apple Silicon)

xcode-select -p >/dev/null 2>&1 || xcode-select --install; curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash && export NVM_DIR="$HOME/.nvm" && . "$NVM_DIR/nvm.sh" && nvm install 22 && curl -fsSL https://bun.sh/install | bash && curl -fsSL https://vibehard.ai/download/install-agent.sh | bash -s -- --mcp-register && npx -y rea-agents@6.1.0 setup --yes --all-detected

Then restart your desktop agent app and, if you use the command-line agent, run claude mcp list. If Apple’s developer-tools window appeared, let it finish before the first build. If the installer asks about REA, answer n (the last step installs the tested version). Intel Macs stay on 2.0.0 for now.

Linux (x64 or arm64)

First, the admin step. Debian or Ubuntu:

sudo apt-get update && sudo apt-get install -y git curl unzip

Fedora:

sudo dnf install -y git curl unzip

Then:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash && export NVM_DIR="$HOME/.nvm" && . "$NVM_DIR/nvm.sh" && nvm install 22 && curl -fsSL https://bun.sh/install | bash && curl -fsSL https://vibehard.ai/download/install-agent.sh | bash -s -- --mcp-register && npx -y rea-agents@6.1.0 setup --yes --all-detected

Claude Code is supported on Linux; Claude Desktop isn’t available on Linux.

Windows

Not supported natively. Use WSL: run wsl --install in PowerShell as Administrator, restart, open Ubuntu, follow the Linux steps above, and use Claude Code inside Ubuntu.