# VibeHard Agent Edition - LLM Instructions

VibeHard is a software factory your own AI agent drives over MCP. The Community Edition (v2.0.7) is free for personal use; commercial use needs the commercial-use license, which comes with the Software Factory plan ($199/mo). Full summary: https://vibehard.ai/llms-full.txt

## Installation (Latest — v2.0.7)
To install the latest VibeHard MCP Server and CLI (v2.0.7):
`curl -fsSL https://vibehard.ai/download/install-agent.sh | bash`
MCP setup and server registration: https://vibehard.ai/mcp (agents: https://vibehard.ai/foragents)

## Upgrading (Latest — v2.0.7)
To upgrade an existing installation to the latest version, run:
`vibehard-agent update`
Installed copies check for a signed update about every 6 hours and verify the signature before installing. Downgrades are refused.

## Direct Release Artifacts (v2.0.7)
Signed manifest: https://vibehard.ai/dist/latest.json
- **macOS (Apple Silicon):** `https://vibehard.ai/dist/vibehard-agent-2.0.7-darwin-arm64.zip`
  - SHA-256: `d3d706e47a1c9e4b9655be1c5e40b5880c310ca041374f47af18765ce48d2472`
- **Linux (x86_64):** `https://vibehard.ai/dist/vibehard-agent-2.0.7-linux-x64`
  - SHA-256: `799799af75c7fd9706276f1dcffc87ac9b698eaecc5119524392cb60269085da`
- **Linux (ARM64):** `https://vibehard.ai/dist/vibehard-agent-2.0.7-linux-arm64`
  - SHA-256: `97e723a1aca436db653d503789897ca115290cf60f0c6c47b008274dbcfa381e`

## First build (a proven sample)
This sample is written in Go. The installer offers to install Go if it's missing; or install it from go.dev/dl.
Start the sample unaided: in an empty folder, with the vibehard-agent MCP server registered, run this prompt exactly:

Use the VibeHard factory (the vibehard-agent MCP tools) to build a program in this folder. This is a quick first experiment, not something I will rely on or share with users. Open a session, then start a build with exactly this request:

word-frequency CLI: reads a plain text file, outputs the N most frequent words with their counts; JSON output; no network; no storage beyond stdout

Then drive the build: keep fetching work orders with vibehard_task_next, do the work each one asks for in this folder, and submit it with vibehard_task_submit, until the job is complete. Do every work order yourself, and follow every output-format instruction it gives. In review and audit outputs, spell each document name exactly as one of the work order's === name === headers, and never dismiss a high-severity finding (fix the document instead). In code: never write skipped or disabled tests, format with the language's standard formatter, make the program accept --help and --version (each prints to stdout and exits 0), and do not leave compiled binaries or build output in the project folder. Whenever VibeHard asks a question or asks for an approval (vibehard_review_next), show me the question, its options and the recommended answer, then stop and wait for my reply. Never answer for me. When the job is complete, tell me where the program is and how to run it.

VibeHard asks a few questions (how it will be used, language, what counts as a word, output shape, response time, concurrency, memory) and then asks for plan approval. Show each question to the person you work for and wait for their reply. For the sample they should answer "A quick experiment" (the other choice needs a signed approval policy that a fresh install lacks), "Go", the recommended option for the word and output questions, any sensible option for the response-time, concurrency and memory batch, then approve the plan. Do not answer for them. Requirements: a container runtime running and the Go toolchain installed. Guide: https://vibehard.ai/first-build . What it can build: https://vibehard.ai/what-you-can-build

## Detect the OS first
Run `uname -s`. Darwin = macOS; Linux = Linux; on Windows, check whether you are inside WSL (`uname -r` mentions "microsoft"). Then use the matching section.

### macOS (Apple Silicon)
```bash
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
```
Afterwards restart the desktop agent app and list your MCP servers to confirm vibehard-agent is registered. If Apple's developer-tools window appeared, let it finish before the first build.

### Linux (x64 or arm64)
Admin step first (Debian or Ubuntu):
```bash
sudo apt-get update && sudo apt-get install -y git curl unzip
```
Fedora: `sudo dnf install -y git curl unzip`
Then:
```bash
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
```
The command-line coding agent is supported on Linux; the desktop chat app has no Linux build.

### Windows
Not supported natively. Use WSL: run `wsl --install` in PowerShell as Administrator, restart, open Ubuntu, follow the Linux steps, and use the command-line agent inside Ubuntu.