docs ▸Ejecútalo en algún sitio ▸Tus propias máquinas

Se ejecuta enWrit CloudAutoalojado

agents ▸ tus máquinas

Tu hardware, en la misma cuenta.

Un agente es el trabajador de Writ. Vincula una máquina que ya tienes con un solo código de emparejamiento y graba y repite workflows de navegador, ejecuta fragmentos de crawl y corre monitors — una conexión saliente, sin puertos entrantes, sin IP pública, sin problema tras un NAT.

Vincular una máquina Dónde se ejecuta

Un run local no lleva ningún cargo de cómputo en ningún plan, sea como sea que se arranque.

agente ▸ qué es

Un trabajador, tres oficios.

El agente es un único programa que ejecutas en una máquina que controlas. Llama hacia fuera al coordinador y espera trabajo; nadie le llama a él.

Graba y repite workflows	Un navegador real en tu máquina, sobre tus propias cuentas con sesión iniciada.
Ejecuta fragmentos de crawl	Un crawl distribuido se reparte entre las máquinas que has vinculado.
Corre monitors	Las comprobaciones programadas se ejecutan en tu hardware, a tu ritmo.

Puede usar tu propia clave de proveedor de IA — OpenAI, Anthropic, Gemini, cualquier endpoint compatible con OpenAI, u Ollama. El trabajo hecho con tu clave no se factura como IA gestionada, y la clave se queda en la máquina.

vincular ▸ dos comandos

Vincula una máquina.

Dos pasos: acuña un código en el panel y luego ejecuta una línea en la máquina. Nunca pegas un token en una shell, así que nada duradero acaba en tu historial.

1 · Acuña un código de emparejamiento

En la app: Fleet → Connect a new agent. Por API: POST /api/user-recorder/pair-code, que responde con el código, cuánto dura, comandos de instalación listos por plataforma y la URL del coordinador que la máquina debe llamar.

pair-code.sh

curl -X POST https://api.usewrit.app/api/user-recorder/pair-code \
  -H "Authorization: Bearer $WRIT_API_KEY"

response

{
  "code": "WRIT-4K2P-9XQ",
  "expires_in": 900,
  "install_commands": {
    "windows": "& ([scriptblock]::Create((irm https://api.usewrit.app/agent.ps1))) WRIT-4K2P-9XQ",
    "macos": "curl -fsSL https://api.usewrit.app/agent.sh | sh -s -- WRIT-4K2P-9XQ",
    "linux": "curl -fsSL https://api.usewrit.app/agent.sh | sh -s -- WRIT-4K2P-9XQ"
  },
  "coordinator_url": "https://api.usewrit.app"
}

Propiedad	Valor
Formato	WRIT-4K2P-9XQ — cuatro caracteres, luego tres, sin letras que se confundan.
Usos	De un solo uso — se gasta en cuanto se canjea.
Vigencia	Caduca a los 15 minutos.
Límite de intentos	20 intentos por hora, por IP.

2 · Ejecuta una línea en la máquina

Pon tu propio código en lugar del de ejemplo. El instalador descarga el agente, canjea el código por sus credenciales y conecta:

macOS / Linux

curl -fsSL https://api.usewrit.app/agent.sh | sh -s -- WRIT-4K2P-9XQ

Windows

& ([scriptblock]::Create((irm https://api.usewrit.app/agent.ps1))) WRIT-4K2P-9XQ

Descargar sin dar de alta

Añade --download-only para descargar el binario y parar ahí — útil para preparar la imagen de una máquina, revisar lo que vas a ejecutar, o dejar listo un host que se dará de alta más tarde. El instalador de Windows toma el código como argumento posicional y no tiene una opción equivalente.

macOS / Linux

curl -fsSL https://api.usewrit.app/agent.sh | sh -s -- --download-only

Si ya estás en el límite de máquinas de tu plan, la acuñación se niega con 402 y te dice cuántas hay conectadas. Desconecta una, o sube de plan.

límites ▸ por plan

Cuántas máquinas, cuántas puertas.

Dos topes distintos que suelen confundirse. Máquinas vinculadas es cuántos ordenadores tuyos pueden estar conectados a la vez. Endpoints publicados y herramientas MCP es cuántas puertas puedes abrir sobre ellos.

Plan	Máquinas vinculadas	Endpoints publicados · herramientas MCP
Free	1	2 · 2
Starter	1	5 · 5
Pro	1	15 · 15
Growth	5	40 · 40
Scale	20	100 · 100
Enterprise	Ilimitado	Ilimitado

Writ Desktop en tu propio ordenador es otra cosa: aquí nunca se cuenta ni se limita, y sus runs locales son gratis en todos los planes.

fleet ▸ la superficie

Ve y gestiona lo que vinculaste.

Todo lo que hace la página Fleet está disponible por API, bajo /api/user-recorder:

Llamada	Qué hace
`GET /agents`	Lista tus máquinas y su estado en vivo.
`PATCH /agents/{agent_id}`	Renombrar una.
`DELETE /agents/{agent_id}`	Desconectar una.
`GET /capability`	Qué permite este plan ahora mismo (abajo).
`GET /byo-ai · PUT /byo-ai`	Leer o fijar la configuración del proveedor de IA de tus agentes.

Qué te dice la llamada capability

Una sola llamada, para que un asistente pueda elegir destino y explicar un bloqueo en vez de fallar con un error de conexión críptico:

`cloud_recording_allowed`	Si la grabación en la nube está permitida en este plan.
`cloud_quota_limit · cloud_quota_used · cloud_quota_remaining`	La cuota mensual de grabación en la nube y lo que queda.
`requires_local_agent_when_exhausted`	Si una máquina vinculada pasa a ser necesaria cuando esa cuota se agota.
`max_user_recorders`	El límite de máquinas de este plan.
`online_local_agents`	Cuántas de tus máquinas están en línea ahora.

Una máquina cuenta como en línea cuando mantiene una conexión viva, o cuando su último latido llegó dentro de los últimos 2 minutos. Cada fila lleva además su nombre, plataforma, nombre de dispositivo, capacidades, estado, sesiones activas y máximas, y qué proveedor de IA usa.

dispatch ▸ dónde cae el trabajo

Dónde se ejecuta el trabajo de verdad.

Dos caminos, y se facturan distinto:

Despachado desde la nube	Un run arrancado en la nube sale hacia tu flota y se ejecuta en una de tus máquinas.
Arrancado en local	Una máquina vinculada puede ejecutar ella misma una instalación del marketplace, bajo un contrato autorizar → ejecutar → finalizar.

En el camino local la decisión de facturación siempre se queda en el servidor — la máquina pregunta, el servidor decide y la máquina informa de lo ocurrido. Un run local no lleva ningún cargo de cómputo en ningún plan, sea como sea que se arranque.

uplink ▸ la forma

Uplink: una llamada que llega a una máquina sin puertos abiertos.

«Uplink» es el nombre de esta forma, no un producto aparte ni una API que se llame. Describe lo que pasa cuando alguien llama a un endpoint publicado cuyo workflow pertenece a tu máquina.

1 · Tu agente mantiene una conexión saliente — Él llamó al coordinador; el coordinador nunca le llama a él.
2 · Llega una llamada a tu endpoint publicado — Una petición HTTPS corriente, desde tu código, un socio o un cliente MCP.
3 · La llamada baja por la conexión que ya existe — No se abre ningún socket nuevo hacia ti.
4 · El workflow se ejecuta en tu máquina — Y el resultado vuelve por el mismo camino.

Sin puerto entrante, sin excepción de cortafuegos, sin IP pública. Los únicos números que pertenecen a Uplink son los topes de endpoints publicados y herramientas MCP de la tabla de arriba — no tiene cuota, ni precio, ni ajustes propios.

máquina ▸ qué necesita

Qué necesita la máquina.

Un driver de navegador Chromium, porque el agente maneja un navegador real. En el primer uso del navegador el agente lo instala solo; también puedes preinstalarlo en una máquina sin salida hacia la descarga, o si prefieres hacerlo al preparar la imagen.

prepare-browser.sh

patchright install chromium
# or, if you already run Playwright on this machine:
playwright install chromium

Ejecuta patchright install chromium o playwright install chromium — el que ya esté en esa máquina.

referencia ▸ siguiente

Sigue

Dónde se ejecuta

Desktop, tus propias máquinas o un servidor tuyo.

→ Autoalojamiento

Ejecuta el coordinador tú mismo, con Docker.

→ Managed endpoints

/v1/{slug}/{path} — las puertas por donde entra una llamada.

→ MCP

Los mismos workflows como herramientas para cualquier cliente MCP.

→ Monitors

Comprobaciones programadas que corren en tu flota.

→ Facturación

Qué se mide y qué no se mide nunca.

→

faq

Preguntas de flota, respondidas.

¿Tengo que abrir un puerto o dar IP pública a la máquina?

No. El agente abre una conexión saliente y la mantiene. Las llamadas a tus endpoints publicados bajan por esa conexión ya existente, así que no hay puerto entrante, ni excepción de cortafuegos, ni IP pública, y funciona tras un NAT.

¿Cuánto dura un código de emparejamiento y puedo reutilizarlo?

Caduca a los 15 minutos y es de un solo uso — canjearlo lo gasta. El canje está limitado a 20 intentos por hora y por IP, así que un código capturado de un historial de shell o de un log de proxy ya está gastado cuando alguien lo prueba.

¿Qué pasa si ya estoy en mi límite de máquinas?

Acuñar un código se niega con 402 y te dice cuántas máquinas hay conectadas. Free, Starter y Pro vinculan una máquina; Growth cinco; Scale veinte; Enterprise es ilimitado. Desconecta una desde la página Fleet, o sube de plan.

¿Ejecutar en mi propia máquina gasta créditos?

No. Un run local no lleva ningún cargo de cómputo en ningún plan, sea como sea que se arranque — despachado desde la nube a tu flota, o arrancado en la propia máquina. Solo se mide el trabajo que corre sobre cómputo operado por Writ.

¿Puede el agente usar mi propia clave de proveedor de IA?

Sí. Apúntalo a OpenAI, Anthropic, Gemini, cualquier endpoint compatible con OpenAI u Ollama, y configúralo con la llamada byo-ai. La clave se queda en la máquina y el trabajo hecho con tu clave no se factura como IA gestionada.

¿Por qué una máquina aparece offline si está funcionando?

En línea significa una conexión viva o un latido dentro de los últimos 2 minutos. Una máquina que acaba de despertar, perdió la red un momento o estuvo en pausa aparece offline hasta que llega su siguiente latido, y entonces vuelve sola.

fin ▸ conectar

Vincula la primera máquina.

Acuña un código, ejecuta una línea, y la máquina entra en tu flota antes de que el código caduque.

Quickstart Dónde se ejecuta