CLI

Comandos

Todos los comandos, qué modifican y cuáles afectan a lo que ven los visitantes.

Ningún comando consume créditos. Solo cuatro grupos modifican lo que ven los visitantes: publish, publish rollback, publish unpublish y domains. Todo lo demás modifica el borrador.

Cuenta

Terminalatelier201 account                 # espacio de trabajo, plan y permisos de esta credencial
atelier201 credits                 # saldo y todos los créditos concedidos
atelier201 usage --from 2026-01-01 # créditos consumidos durante un periodo

Sitios

Terminalatelier201 sites list
atelier201 sites create "Maison Dupont" --slug maison-dupont --locale fr --link
atelier201 sites get
atelier201 sites rename "Maison Dupont Boulangerie"
atelier201 sites delete            # te pide que escribas el slug; en un script, --confirm <slug>

sites create parte de la plantilla inicial de Atelier201 y la compila una vez. Un sitio eliminado deja de estar disponible de inmediato y se borra en unos minutos. Ejecuta atelier201 site pull antes si crees que puedes necesitarlo.

Una carpeta de proyecto

Terminalatelier201 site link --site <id>   # vincula esta carpeta a un sitio
atelier201 site pull               # descarga aquí los archivos del borrador
atelier201 site push --message "New menu" --build --wait

site push sustituye el borrador por el contenido de la carpeta en una sola entrada del historial. Omite node_modules, dist, .astro, .git, los archivos .env y las claves, así como todo lo que indique el .gitignore de la raíz. El límite es de 50 MB. Se niega a sobrescribir cambios realizados en el sitio desde la última sincronización (ejecuta antes site pull o usa --force), y site pull se niega a sobrescribir un archivo que hayas modificado localmente.

Contenido

Terminalatelier201 content model
atelier201 content list blog
atelier201 content get blog hello-world
atelier201 content save blog hello-world --data entry.json --body hello.md
atelier201 content delete blog hello-world
atelier201 content singleton business
atelier201 content save-singleton business --data business.json
atelier201 content set business:/hours/2/close "18:00"
atelier201 content set business:/seats 12 --as number
atelier201 content replace "Open 9 to 5" "Open 9 to 6"
atelier201 sites apply plan.json
atelier201 media place business:/hero/image --query "bakery counter with fresh bread" --alt "Our counter"

Consulta primero content model. El sistema valida todas las modificaciones conforme a ese modelo. --expect <hash> solo guarda si la entrada sigue teniendo el hash que consultaste, y --create-only impide sobrescribir contenido.

Archivos, historial y conjuntos de cambios

Terminalatelier201 files list --under src/content
atelier201 files read src/pages/index.astro
atelier201 files search "opening hours"
atelier201 files commit --message "Update the menu" --put src/pages/menu.astro=menu.astro
atelier201 history list
atelier201 history compare --to <revision>
atelier201 history restore <revision>
atelier201 changesets open "Add a gallery page"
atelier201 changesets stage <changeset_id> --put src/pages/gallery.astro=gallery.astro
atelier201 changesets commit <changeset_id>

files commit crea una entrada del historial. --expect <path>=<hash> rechaza el cambio completo, con el código de salida 6, si el archivo ha cambiado desde que lo consultaste. Un conjunto de cambios hace lo mismo en varias llamadas y permanece abierto durante 10 minutos. history restore añade una nueva entrada que coincide con una anterior, sin borrar nada.

Contenido multimedia

Terminalatelier201 media list
atelier201 media upload photo.jpg --alt "A loaf of bread"
atelier201 media delete media/photo.jpg
atelier201 media stock search bakery counter morning light
atelier201 media stock import pixabay 1234567 --alt "Croissants on a bakery counter"
atelier201 media models
atelier201 media generate --model p-image --estimate "a sunlit bakery counter, flat illustration"
atelier201 media generate --model nano-banana "a sunlit bakery counter, photo, no text" --alt "A bakery counter"
atelier201 media generation <generation_id> --wait

La búsqueda e importación de imágenes de stock son gratuitas. media generate consume créditos: muestra el precio exacto y pide confirmación (--yes la acepta y es obligatorio si no hay terminal). Además, requiere el permiso media:generate, que atelier201 auth login no solicita, salvo que lo añadas con --scope.

Compilación y vista previa

Terminalatelier201 builds start --wait
atelier201 builds list
atelier201 builds get <build_id>
atelier201 builds log <build_id>
atelier201 previews create --days 7
atelier201 previews list
atelier201 previews revoke <preview_id>

builds start --wait espera hasta 5 minutos. Finaliza con el código 0 si la compilación está ready; si falla, termina con un código distinto de cero y muestra el final del registro de compilación.

Publicación

Terminalatelier201 publish review                       # indica qué compilación se publicará y los bloqueos; no modifica nada
atelier201 publish                              # la compilación lista más reciente; pide confirmación
atelier201 publish --build <build_id>
atelier201 publish history
atelier201 publish rollback --publication <id>
atelier201 publish unpublish

publish, publish rollback y publish unpublish muestran qué va a cambiar y piden confirmación. En un script, pasa --yes. Cada comando consulta primero el estado y envía la versión que ha consultado, por lo que, si otra persona publica mientras tanto, la operación se rechaza con el código de salida 6 en lugar de sobrescribir sus cambios.

Dominios

Terminalatelier201 domains list
atelier201 domains add www.example.com   # muestra los registros DNS que debes crear
atelier201 domains check <domain_id>
atelier201 domains address <slug>
atelier201 domains main <domain_id>
atelier201 domains remove <domain_id>

Para usar un dominio personalizado necesitas un plan de pago. Consulta Dominios.

Antes de que nadie inicie sesión

Terminalatelier201 site push --guest --name "Maison Dupont"

No hace falta tener una cuenta. Sube la carpeta a internet como demostración e imprime dos enlaces: el de la demostración y un enlace privado que solo debes compartir con el propietario para que el sitio pase a ser suyo. Consulta Sitios de invitados.

Manuales

Terminalatelier201 skills list
atelier201 skills get create-site

Son los manuales que utiliza el asistente de Atelier201: antes de empezar una tarea, lee el que corresponda. No hace falta iniciar sesión. En un terminal, get muestra Markdown; si se canaliza su salida o se usa --json, muestra el objeto JSON (con body).

Recursos avanzados

Terminalatelier201 api GET /sites
atelier201 api POST /sites --data '{"name":"Maison Dupont"}'
atelier201 doctor
atelier201 mcp
atelier201 feedback send --problem "..." --situation "..." --expected-solution "..."

atelier201 api permite acceder a cualquier endpoint, incluso a los que se añadan después de tu versión de la CLI, así que no hace falta esperar a una nueva versión para usar una función nueva. atelier201 doctor comprueba la conectividad, las credenciales, la versión y el desfase del reloj. atelier201 mcp conecta stdio con el servidor MCP para los clientes que no pueden comunicarse por HTTP.