Inicio rápido

Necesitas Node.js 24 o posterior. La cuenta de Cloudflare se necesita más adelante, cuando despliegues.

Crea un proyecto

npm create hollware my-cms

Copia el starter en my-cms, lo instala, crea la base de datos local y genera tu sitio, su dueño y un primer token personal. Al final imprime tres cosas:

• el token, una sola vez: cópialo ahora, porque Hollware guarda solo su hash (o pasa --token-file owner.token y va a ese archivo);
• un enlace para configurar tu passkey del admin, válido por siete días, para cuando lo quieras: tu agente trabaja solo con el token;
• cómo conectar un agente: la línea para Claude Code y el bloque para cualquier otro cliente.

No pregunta nada. Las opciones van después de --, que npm necesita para pasarlas:

npm create hollware my-cms -- --token-file owner.token   # el token a un archivo, nunca en pantalla
npm create hollware my-cms -- --no-git          # sin git init
npm create hollware my-cms -- --preset docs --locales en,es   # partir de docs, en dos locales
pnpm create hollware my-cms --pm pnpm           # instalar con pnpm
npm create hollware -- --help                   # todas las opciones

Inícialo

cd my-cms
npx hollware dev

Dice Hollware is ready at http://localhost:5199 cuando ya responde. MCP está en /mcp, el admin en /admin/, la API de lectura en /v1 y el chequeo de estado en /health. Detenlo con Ctrl+C. Un agente que debe seguir trabajando corre npx hollware dev --detach y, al final, npx hollware dev --stop.

Ejecuta cada comando npx hollware … desde dentro de my-cms: la CLI trabaja sobre el proyecto del directorio actual y sobre su base de datos local, salvo que pases --remote.

Conecta tu agente

Pon el token en el entorno y pega la línea que imprimió la instalación (o pídesela a npx hollware mcp-config, con --client cursor o --client vscode para esos):

export HOLLWARE_TOKEN="$(cat owner.token)"
claude mcp add --transport http hollware http://localhost:5199/mcp --header 'Authorization: Bearer ${HOLLWARE_TOKEN}'

Luego pídele a tu agente que escriba algo:

Lee el sitio de Hollware, escribe un post corto en inglés sobre por qué el texto plano perdura, y publícalo.

El agente llama a describe_site para conocer tus colecciones y reglas, escribe con create_draft, corrige lo que informa el veredicto y llama a publish.

Un post del blog del starter, si lo escribes tú, se ve así. describe_site entrega las mismas reglas como un JSON Schema:

---
title: Why plain text lasts
description: Files that any editor opens outlive the tools that made them.
date: 2026-10-15
tags:
  - writing
translationGroup: why-plain-text-lasts
---

# Why plain text lasts

Plain text opens anywhere, diffs cleanly and needs no migration.

Revísalo

Abre http://localhost:5199/admin/, inicia sesión con la passkey que configuraste y encontrarás el post en Entradas, con cada una de sus revisiones.

Siguientes pasos

• Conecta un agente con más detalle, con OAuth en vez de un token.
• Configura tu contenido para hacer tuyo el blog del starter.
• Despliega cuando estés listo.