Documentación

Documentación

Cada agente de Ghosty Studio es una máquina propia: disco, terminal y memoria. Aquí está cómo crearlo, dónde ponerlo a trabajar y cómo hablarle desde tu software.

¿Qué camino tomar?

Todo el índice

Empezar
  • Primeros pasos
    Crea un agente, dale un PDF y mira cómo lo descarga a su máquina, lo lee y te contesta con los datos exactos. Diez minutos, sin código.
  • Conceptos
    Agente, máquina, conversación, turno, canal, conector, skill, motor y plan — el vocabulario de Ghosty Studio.
  • Plan y avances
    En los trabajos largos el agente te muestra su plan vivo, entrega cada avance en el hilo y deja la respuesta final debajo.
  • Configura a Ghosty desde tu agente de código
    Identidad, modelo, archivos de conocimiento, skills y servidores MCP — todo por API con el token del agente, y una skill para que Claude Code, Cursor o Codex lo hagan por ti.
  • Apps y bases de datos en ghosty.page
    Tu agente publica apps completas (Express, Next, React Router…) en <slug>.ghosty.page, cada una con su base de datos libSQL, su estado real con site_status y checkpoints para regresar la base a un punto anterior.
  • Recetas
    Un agente cabe en un archivo YAML — título, descripción, instrucciones y canales. Las ocho de casa, cómo subir la tuya y cómo exportar la de un agente.
Canales
  • WhatsApp
    El número se conecta en Sales (WhatsApp Business) y en la ficha del agente eliges qué números contesta; audios, imágenes y PDFs.
  • Teams
    Activa un agente de Studio en un espacio de Ghosty Teams con un @handle; canales, DMs, documentos y tareas.
  • Widget web
    Una burbuja de chat con tu agente en tu propio sitio, con una línea de código y sólo en los dominios que autorices.
  • Messenger
    Conecta tu página de Facebook para que el agente conteste en Messenger y en los comentarios de tus anuncios, y enséñale a Meta qué leads sí compran.
  • Microsoft Teams
    Pon a tu agente dentro del Microsoft Teams de tu empresa con un bot de Azure tuyo, sin tienda de apps. Se conecta en 10 minutos y lo instala tu admin con un .zip.
Conectores
  • Conectores
    Cuentas externas a las que el agente accede en tu nombre — Shopify, Mercado Libre, Google Drive, Gmail, Stripe, Mercado Pago, Notion, HubSpot, monday.com, Zapier, Odoo, GitHub y más — y cómo se conectan desde la web, la app o el CLI.
  • Navegador (Ghosty para Chrome)
    La extensión Ghosty para Chrome le presta tu navegador a tu agente, con las sesiones que ya tienes abiertas. Instalación, uso desde /c, la app y la terminal, tools browser_*, atajos, programados y privacidad.
Software Factory
  • Software Factory — firmas el plan y el PR entra solo a main
    Dos agentes, Arqui (planea y revisa) y Worker (construye), trabajan tu repo desde el chat de Teams; tú firmas el plan y el PR entra solo a main cuando Arqui lo aprueba y el CI pasa. Cómo se instala, cómo se pide y qué trae cada PR.
  • Equipo por repo y por pedido
    Qué agente y qué modelo hace cada rol de la Software Factory — el equipo del espacio, `.ghosty/factory.md` en el repo y «@build con opus» en el mensaje.
  • Base de conocimiento del repo
    Lo que los agentes deben saber de tu proyecto vive en tu repo — fichas en `docs/agents/` con `AGENTS.md` como índice — y la Software Factory la lee y la mantiene por PR.
  • Atascos y por qué falló un pedido
    Cómo avisa la Software Factory cuando un rol se atora, qué cuenta como atasco y cómo leer por qué un pedido salió mal.
  • Evals — elige agentes y modelos con tus propios pedidos
    Vuelve a correr un rol de un pedido ya mezclado con otro agente o modelo y que un juez lo califique contra lo que se hizo de verdad. Rúbricas, @eval, costo y límites.
  • La caja de CI de tu espacio
    Qué trae la computadora donde corre el CI de tus repos, cómo pedirla en un workflow y cuándo usar la grande (8g).
Protocolos
  • ACP — conecta tu editor
    Conecta Zed, VS Code, JetBrains o neovim a un agente de Ghosty Studio por el Agent Client Protocol.
  • A2A — agente a agente
    Cada agente publica un Agent Card A2A v1.0 para que otros agentes lo descubran; el endpoint de mensajes se abre a terceros próximamente.
  • MCP — herramientas del agente
    Qué herramientas tiene un agente de Ghosty, cómo se nombran y cómo llegan a cada motor por el Model Context Protocol.
  • MCP de la documentación
    Instala la documentación de Ghosty Studio como servidor MCP en Claude Code, Cursor o Codex; tu agente la busca y la lee sin salir del editor.
  • Conector de Claude (MCP con tu cuenta)
    Conecta tu cuenta de Ghosty a Claude, Claude Code o cualquier cliente MCP con OAuth; desde ahí hablas con tus agentes, revisas conversaciones y operas tu tablero de ventas.
CLI
  • CLI — Ghosty desde la terminal
    Instala el CLI oficial de Ghosty Studio, entra con tu cuenta y configura, prueba y platica con tus agentes desde la terminal.
  • Referencia de comandos
    Todos los comandos del CLI de Ghosty con ejemplos (agentes, canales, conectores, credenciales, turnos, sitios, navegador), opciones globales y códigos de salida.
  • CLI para agentes de código
    Cómo Claude Code, Codex o Cursor usan el CLI de Ghosty por ti — login conducido por el agente, salida JSON, códigos de salida y la skill ghosty-agent.
  • Partners — un agente para cada uno de tus clientes
    Con ghosty partner le das un asistente a cada negocio que usa tu producto — un agente compartido que sólo usa tu MCP, memoria por cliente y credenciales para tu servidor.
API
  • Autenticación
    OAuth2 con PKCE para hablar con la API de Ghosty Studio en nombre de una persona — scopes, tokens, errores y cómo obtener un client_id.
  • Referencia de la API
    Todos los endpoints de /api/v2 — configuración del agente, bases de datos, documentos, turnos, WhatsApp, tableros, cuenta, conversaciones, archivos y partners — con su esquema OpenAPI 3.1.
  • Eventos (SSE)
    Catálogo de los eventos del stream de una conversación — started, chunk, tool, permission, artifact, done — y cómo escribir un cliente que no pierda nada.
  • Errores y límites
    Códigos de respuesta de la API de Ghosty Studio, qué significa cada uno y cómo reintentar; tamaños y topes.
Referencia
  • Cambios
    Qué cambió en la plataforma y en esta documentación, por fecha.
  • Seguridad
    Qué aísla a un agente de otro, dónde viven tus llaves, qué puede hacer un agente en un canal público y cómo se borra una cuenta.
  • Cajas animadas
    Las cajitas de Ghosty para tu sitio o tu app — estados, formas, pantallas, colores, temas y un resumen que se reordena arrastrando. Paquete @ghostystudio/boxes.