Skip to main content
Glama

@unravel-tech/thing

CLI para thing: publica, versiona y comparte artefactos (páginas HTML, documentos Markdown, imágenes independientes y PDFs) desde agentes de codificación.

npm i -g @unravel-tech/thing
thing login                          # defaults to https://usething.ai
thing push report.html --json
thing push notes.md --json           # Markdown gets a styled reader view
thing push chart.png --json          # images and PDFs too

Comandos

Comando

Qué hace

thing login [--server url]

Inicio de sesión con código de dispositivo; guarda un token (no fija un equipo)

thing logout / thing whoami

Borrar / mostrar la identidad actual y dónde van a parar los envíos

thing default [team] [--clear]

Mostrar o establecer tu destino de envío predeterminado en el servidor (se usa cuando no se indica --team, desde cualquier máquina)

thing use <team> [project]

Establece una anulación local de equipo/proyecto activo para esta máquina

thing push <file.html|.md|.pdf|.png|.jpg|.gif|.webp> [--name x] [--team t] [--project p] [--visibility v]

Envía una nueva versión inmutable (HTML, Markdown o imagen/PDF) e imprime la URL servida

thing list

Enumera los artefactos que puedes ver

thing versions <name>

Historial de versiones de un artefacto

thing rollback <name> <n>

Vuelve a apuntar la última versión a la versión n

thing open <name>

Abre el artefacto en un navegador

thing mcp

Ejecuta un servidor Model Context Protocol sobre stdio (herramientas: push_artifact, list_artifacts, whoami)

Todos los comandos aceptan --json para obtener una salida legible por máquina.

Valores de visibilidad: private, team, anyone-with-link (imprime una URL de uso compartido con token), public.

Related MCP server: Just Publish MCP Server

Resolución de contexto

El equipo en el que aterriza un envío se decide en este orden: la opción --team → .thing.json en el directorio de trabajo → una anulación local de thing use → tu predeterminado del lado del servidor (thing default) → tu espacio personal. El inicio de sesión ya no fija un equipo, así que si no hay ninguna anulación configurada, el servidor elige tu predeterminado (p. ej., la organización Unravel para los miembros de Unravel).

MCP

Claude Code, Cursor, Codex y cualquier otra cosa que hable Model Context Protocol pueden publicar a través de thing. No se necesita iniciar sesión en la terminal: crea un token en usething.ai en Configuración, luego Tokens, y pégalo en la configuración MCP de tu cliente.

{
  "mcpServers": {
    "thing": {
      "command": "npx",
      "args": ["-y", "@unravel-tech/thing", "mcp"],
      "env": { "THING_TOKEN": "paste-your-token-here" }
    }
  }
}

El servidor expone tres herramientas: push_artifact para publicar un archivo o contenido en línea y obtener un enlace, list_artifacts para ver lo que tienes y whoami para comprobar a qué cuenta y equipo estás enviando.

Si ya has ejecutado thing login, se usa la credencial almacenada y se puede omitir THING_TOKEN.

Requiere Node >= 18 o Bun. No tiene dependencias en tiempo de ejecución.

Related MCP Connectors

Related MCP Servers