RestRuno

Cliente REST de escritorio (Windows, macOS y Linux) — estilo Postman/Bruno, con colecciones 100 % locales, variables, scripts, runner con datos y generación de CSV.

Free y Pro

RestRuno es gratis para el trabajo diario: colecciones, peticiones, ambientes, variables, scripts con tests, import/export Postman/Bruno, cookies y consola. Las funciones avanzadas forman parte de RestRuno Pro (pago único, licencia para 2 dispositivos):

Comprar RestRuno Pro — $20 — pago único, actualizaciones incluidas, 2 dispositivos. La compra la procesa Polar y recibes tu license key por email; actívala en la app con el botón Upgrade de la barra superior. Términos de uso en la licencia (EULA).

¿Para tu equipo? RestRuno Enterprise — $149: pago único, 25 seats (una sola key para todo el equipo, 50 activaciones), rollout simple y soporte prioritario por email.

Instalación y actualizaciones

Instalar (los botones de restruno.com detectan tu sistema, o descarga del release más reciente):

• Windows (recomendado): instalar desde la Microsoft Store — firmado por Microsoft, sin avisos de SmartScreen y con actualizaciones gestionadas por la Store.
• Windows (instalador directo): restruno-X.Y.Z-setup.exe — instalador de un clic (Windows mostrará "editor desconocido" por ser una app sin firma: Más información → Ejecutar de todas formas).
• macOS: restruno-X.Y.Z-arm64.dmg para Apple Silicon (chips M) o restruno-X.Y.Z-x64.dmg para Macs Intel — abre el dmg y arrastra RestRuno a Aplicaciones.
• macOS con Homebrew: brew install --cask LuisBP90/restruno/restruno — detecta tu chip automáticamente.
• Linux (x64): restruno-X.Y.Z.AppImage — dale permiso de ejecución (chmod +x restruno-*.AppImage) y ábrelo; formato recomendado porque es el único con auto-update en Linux. Alternativa Debian/Ubuntu: restruno_X.Y.Z_amd64.deb (sudo apt install ./restruno_*.deb), sin auto-update — se actualiza instalando el deb nuevo.

Actualizaciones:

1. Automáticas y silenciosas: poco después de abrir la app (cuando ya terminó de cargar, para no estorbar el arranque) se revisa este repositorio; si hay versión nueva se descarga completa en segundo plano.
2. Cuando la descarga está lista aparece un botón naranja Update en la esquina inferior derecha: clic → se instala y la app se reinicia. Si no lo pulsas, la actualización se instala sola al cerrar la app.
3. Buscar manualmente: haz clic en el número de versión (vX.Y.Z) de la esquina inferior derecha. Te dice al momento si hay versión nueva (y arranca la descarga en segundo plano), si ya estás al día, o el error si no hay conexión.
4. Botón Docs (barra superior) abre esta documentación en tu navegador.

Colecciones

Una colección es una carpeta en tu disco que tú eliges. Cada petición es un archivo *.rr.json legible; las subcarpetas son folders. Puedes versionarlas con Git o respaldarlas copiando la carpeta.

Peticiones

• URL y Params sincronizados: agrega params en la pestaña Params y aparecen en la URL (y al revés, escribe ?a=1&b=2 en la URL y se llena la tabla).
• Auth: None, Bearer, Basic, API Key, OAuth 2.0 (client credentials), JWT firmado y AWS Signature v4 — ver Autenticación.
• Body: JSON, XML (SOAP), GraphQL (query + variables JSON), texto plano, form-url-encoded o multipart form (campos de texto y archivos). Selector de Content-Type visible, botón Beautify para JSON/XML, y el cURL exportado usa -F para multipart.
• Petición nueva desde los tabs: el botón + junto a los tabs (o Ctrl/Cmd+T) abre un borrador que puedes editar y enviar al momento. Solo se guarda en disco cuando pulsas Save, que te pide nombre y colección o folder. Los borradores sobreviven a un reinicio.
• Cerrar tabs en grupo: el botón ✕ ▾ a la derecha del + (o click derecho en un tab) cierra todos, solo los guardados (deja abiertos los que tienen cambios y los borradores), los otros o los que están a la derecha. Si hay cambios sin guardar, pregunta antes.
• Enviar: botón Send o Ctrl+Enter · Guardar: Save o Ctrl+S (el punto naranja en el tab indica cambios sin guardar).
• Copiar como cURL: botón cURL — copia el comando con todas las variables resueltas a su valor actual.
• Pegar un cURL: pega cualquier comando curl en el campo de URL y se configuran método, URL, params, headers, auth y body automáticamente.
• Response: status, tiempo, tamaño, fecha/hora y URL final (ambos ocultables con los botones ⏱ y URL), body con formato, headers, resultados de tests y consola. El panel puede ir abajo o al costado (botón ⬓/◨ en la barra superior) y la posición elegida se recuerda al cerrar y volver a abrir.
• Qué lleva cada pestaña de un vistazo: Params, Headers y Scripts muestran un contador entre paréntesis, y Body y Auth un punto naranja cuando tienen algo configurado.
• Ancho de columna ajustable: arrastra el separador entre el campo clave y el valor (Params, Headers, bodies de formulario, ambientes, variables de colección y globales). El ancho es común a todas las tablas y se conserva entre sesiones; doble clic lo restablece.
• Si la petición falla: el panel de respuesta explica el error en lenguaje llano — «no se pudo conectar con localhost:9999, conexión rechazada», host que no resuelve, timeout, problema de certificado TLS o puerto inválido — más un bloque What to check con los pasos a seguir.

Autenticación (pestaña Auth de cada petición)

Cada petición elige su propio esquema. Todos los campos aceptan {{variables}}, así que las credenciales pueden vivir en un ambiente o en las globales y no dentro del archivo .rr.json que subes a git.

• Si la petición ya define un header Authorization propio (pestaña Headers o un script), ese manda: la auth no lo pisa.
• Si la autenticación no se puede aplicar (payload JWT inválido, token endpoint caído…), la petición se envía igual sin ella y aparece una línea [auth] en la consola explicando por qué — casi siempre el 401 del servidor dice más que un error local.
• El botón cURL incluye la autenticación ya resuelta. Excepción: con OAuth 2.0 no llama al token endpoint solo para generar el comando; usa el token cacheado si ya enviaste la petición alguna vez.

Variables

Sintaxis {{variable}} en URL, params, headers, auth y body. Precedencia (mayor gana):

runtime (scripts) → fila del data file → colección → ambiente → globales

• Globales: botón Globals (aplican a todas las colecciones).
• De ambiente: selector arriba a la derecha; se administran en Manage Environments (por colección), que se abre directamente en el ambiente activo. Desde ahí también puedes copiar variables a otra colección (seleccionadas o todas).
• De colección: click derecho en la colección → Collection Variables.

Scripts (pestaña Scripts de cada petición)

Dos paneles: Pre Request (antes de enviar) y Post Response (validaciones). Cada panel tiene un menú Snippets… con ejemplos listos y un botón ⛶ para maximizarlo.

// Pre Request
rr.variables.set('token', 'abc');              // runtime: solo memoria, fluye entre peticiones
rr.variables.setGlobal('clave', 'valor');      // se guarda en globales (globals.json)
rr.variables.setEnvironment('token', 'abc');   // se guarda en el AMBIENTE ACTIVO (environments/<nombre>.json)
rr.request.headers['X-Trace'] = '1';           // modificar la petición saliente

// Post Response (tests)
rr.test('status es 200', () => rr.expect(rr.response.status).toBe(200));
rr.test('tiene id', () => rr.expect(rr.response.body.id).toBeDefined());
rr.variables.set('token', rr.response.body.token);  // encadenar login → siguiente petición

Referencia de comandos rr

Los scripts son JavaScript síncrono en un sandbox. No hay require/import/fetch/process/setTimeout, ni async/await, ni acceso a red. Timeout de 5 segundos.

Variables (funcionan en pre y post):

Los valores se guardan como texto — usa JSON.stringify(obj) si necesitas guardar un objeto, y JSON.parse(...) al leerlo.

Pre Request — modificar la petición antes de enviarla (solo en el script pre):

Post Response — leer la respuesta (solo en el script post):

Tests (post) — cada rr.test se reporta como pass/fail en el runner y el panel de respuesta:

• rr.test('nombre', () => { ... })
• rr.expect(actual) con matchers: .toBe(x) (=== estricto), .toEqual(x) (comparación profunda), .toContain(x) (item de array o substring), .toBeDefined(), .toBeLessThan(n), .toBeGreaterThan(n), .toMatch(regexOStr), y el prefijo de negación .not (ej. rr.expect(s).not.toBe(500)).

console.log/info/warn/error(...) se captura y aparece en la consola global.

Ejemplo completo (post-response de un login que guarda el token de forma persistente):

rr.test('login OK', () => rr.expect(rr.response.status).toBe(200));
rr.test('devuelve token', () => rr.expect(rr.response.body.access_token).toBeDefined());
rr.test('content-type json', () =>
  rr.expect(rr.response.headers['content-type']).toMatch(/application\/json/));

// guarda el token en el ambiente activo para las siguientes peticiones:
rr.variables.setEnvironment('token', rr.response.body.access_token);
console.log('token guardado:', rr.response.body.access_token);

El menú Snippets… de cada panel inserta muchos de estos patrones listos para usar. Si tienes el asistente de IA activado, el botón ✨ genera scripts a partir de una descripción usando esta misma referencia.

Runner (Pro)

Función de RestRuno Pro desde la versión 3.0.

Click derecho en una colección o folder → Run Collection / Run Folder. Se abre como un tab de pantalla completa:

• Dos vistas (botón ⬓/◨ del runner): apilada, o dividida con la configuración a la izquierda y las ejecuciones a la derecha. Mientras el run está en curso, la configuración se oculta para dar todo el espacio a los resultados.
• Selección de peticiones: checkboxes para ejecutar solo un subconjunto. La selección se conserva entre ejecuciones del mismo scope — puedes correr, ajustar y repetir sin re-marcar.
• Data file (CSV / JSON / TXT): repite la secuencia una vez por fila; cada columna se vuelve una {{variable}} (TXT usa la variable value).
• Iterations: campo junto al Run — cuántas iteraciones ejecutar. Con data file, el máximo es su cantidad de filas; sin archivo, repite la secuencia las veces que indiques.
• Workers (paralelismo): cuántas iteraciones corren al mismo tiempo (1 a 32; 1 = secuencial). Dentro de cada iteración las peticiones siguen en orden, así que un token capturado en el login sigue llegando a las siguientes. Los resultados y el CSV de salida se muestran ordenados por iteración. Útil con data files grandes o para una prueba de carga ligera.
• Orden: las peticiones corren en el orden del panel lateral — reordénalas arrastrando (ver Colecciones).
• Resultados con detalle completo: expande cualquier ejecución para ver sus tests, la consola, y los bloques Request (método, URL resuelta, headers, body enviado) y Response (status, headers, body). Los bodies muy grandes se recortan en pantalla; con Persist tienes la copia completa.
• Persistir ejecuciones: checkbox que guarda el request resuelto + response completo de cada ejecución en runs/ dentro de la colección.
• Generar CSV (sección contraíble ▸): activa Generate CSV file from response values, elige carpeta y nombre, y define columnas con expresiones sobre el response: body.data[0].id, status, headers.content-type, timeMs, request.url, iteration. Cada columna puede ser text (valor tal cual) o number (elimina ceros a la izquierda: 00742 → 742). El selector Save always / Only passed / Only failed controla qué ejecuciones escriben fila — y en todos los casos, solo se escribe la fila si al menos una expresión hace match.
• Los fallos no detienen el run; puedes cancelar en cualquier momento (cancela también las peticiones en curso de todos los workers).

¿Lo quieres fuera de la app, en un pipeline? Usa la línea de comandos restruno run: mismo motor, mismos resultados.

Línea de comandos: restruno-cli (Pro)

Función de RestRuno Pro desde la versión 3.10. Paquete npm: restruno-cli (Node 20+).

restruno run ejecuta una colección (o un solo folder) con sus scripts y tests desde una terminal o un CI — estilo newman, pero sobre tus carpetas de RestRuno tal cual están en disco. Usa el mismo motor que el Runner: ambientes, data files, iteraciones, workers y rr.test() se comportan igual.

Instalación y licencia

# sin instalar
npx restruno-cli run ./MiColeccion

# o instalado globalmente (comando: restruno)
npm install -g restruno-cli
restruno run ./MiColeccion --env dev

• Licencia: exporta tu key Pro en RESTRUNO_LICENSE_KEY (en CI, como secret). Se valida online en cada ejecución sin gastar activaciones, así que puedes usarla en todas tus máquinas de CI y contenedores. También existe --license-key, pero queda en el historial de la shell — mejor la variable de entorno.
• Sin acceso a internet para validar la licencia, el CLI termina con código 3.

Opciones

Códigos de salida: 0 todo pasó · 1 falló un request o test (o no se ejecutó nada) · 2 error de uso o configuración (opción inválida, carpeta que no es colección, ambiente o folder inexistente, data file faltante) · 3 error de licencia · 130 cancelado con Ctrl+C.

Ejemplo en CI (GitHub Actions)

- uses: actions/setup-node@v4
  with:
    node-version: 20
- name: API tests
  env:
    RESTRUNO_LICENSE_KEY: ${{ secrets.RESTRUNO_LICENSE_KEY }}
  run: npx restruno-cli run ./api-tests --env staging --workers 4 --reporter cli,junit
- uses: actions/upload-artifact@v4
  if: always()
  with:
    name: api-test-reports
    path: restruno-reports/

El reporte JUnit trae un <testsuite> por request ejecutado y un <testcase> por cada rr.test(); un request sin tests es un testcase que falla con HTTP ≥ 400. Lo leen tal cual los reportes de tests de GitHub Actions, GitLab (artifacts:reports:junit) y Jenkins.

Diferencias con la app

• Las globales viven en una carpeta temporal por ejecución (sembradas con --globals); el globals.json de la app no se lee ni se modifica.
• rr.variables.setEnvironment() sí escribe en el archivo del ambiente de la colección, como en la app — en CI eso modifica la copia descargada del repo.
• El cookie jar empieza vacío y vive solo durante la ejecución.

Asistente de IA (Pro)

Función de RestRuno Pro desde la versión 3.0. La configuración es libre; ejecutar acciones de IA requiere licencia.

Botón ✨ AI en la barra superior. Conecta cualquier endpoint compatible con OpenAI: OpenAI, Ollama, LM Studio, OpenRouter, Groq, etc. Es totalmente opcional — si no lo configuras, RestRuno funciona exactamente igual y no aparece ningún botón de IA.

💡 Funciona con modelos open source — gratis y 100 % en tu máquina. Instala Ollama o LM Studio y usa Llama, Mistral, DeepSeek, Qwen, Gemma, o cualquier otro modelo abierto, corriendo localmente: sin pagar ninguna API, sin suscripciones y sin que tus requests salgan de tu computadora. También puedes usar modelos open source alojados (OpenRouter, Groq) si prefieres no correrlos tú.

Configuración (se guarda solo en tu computadora):

Marca Enable AI assistant, usa Test Connection para verificar, y guarda. El botón ✨ AI de la barra superior muestra un punto verde cuando está habilitado y el último test de conexión fue exitoso (gris si está deshabilitado o sin verificar). Al habilitarlo aparecen botones ✨ en tres lugares:

1. Scripts (pre y post) — ✨ en el encabezado de cada panel: describe lo que necesitas ("valida que el status sea 201 y guarda el id en una variable") y genera el script usando la API rr.* correcta, con el contexto de tu request. Botón Insert into script lo agrega al editor.
2. Response — botón ✨ Explain: analiza el request + response + tests fallidos y te explica qué pasó, la causa probable del error y cómo corregirlo.
3. Columnas CSV del Runner — ✨ AI expression: describe el valor que quieres extraer ("el id del primer item") y genera la expresión (body.items[0].id) usando como contexto el último response del run; Add as column la agrega directo.

En cada acción puedes editar la instrucción, regenerar, copiar o insertar el resultado. Privacidad: al usar estas acciones, el request/response involucrado se envía a tu proveedor de IA configurado — con Ollama/LM Studio todo queda en tu máquina.

Ejemplos de uso:

• Scripts: "valida que el status sea 201, que el body tenga id numérico, y guarda access_token en el ambiente activo" → genera el post-response con rr.test, rr.expect y rr.variables.setEnvironment listos para insertar.
• Explain: ante un 500 inesperado, ✨ Explain te dice qué salió mal (header faltante, body mal formado, error del servidor) y qué corregir.
• Runner CSV: "el email del segundo usuario de la lista" → genera body.users[1].email y la agrega como columna.

Consola global

Barra Console al pie de la ventana: registra cada petición enviada, cada ejecución del runner y los console.log de tus scripts. Filtros All / Requests / Errors / Logs, fecha y hora ocultable, y botón Clear.

Servidor local MCP + API (Pro)

Función de RestRuno Pro desde la versión 3.0.

Botón MCP Server en la barra superior. Permite que una IA (Claude, GitHub Copilot, Cursor, Antigravity, OpenAI Codex, etc.) controle RestRuno: crear, editar, eliminar y enviar requests, y leer el response, la consola y los errores — todo local, sin nube.

• 100% local: escucha solo en 127.0.0.1 (nunca accesible desde fuera de tu equipo). Desactivado por defecto.
• Punto de estado: el botón MCP Server muestra un punto verde cuando el servidor está encendido y gris cuando está apagado.
• Token bearer: cada petición externa debe presentar el token que se muestra en la ventana (puedes regenerarlo). Cópialo con un click.
• El servidor solo actúa sobre las colecciones que tienes abiertas en la app; no puede leer ni escribir archivos fuera de ellas.

Cómo configurarlo

1. Abre MCP Server → marca Enable local server (aparece "● running").
2. Copia el MCP endpoint (http://127.0.0.1:<puerto>/mcp) y el Bearer token.
3. En Connect your AI — pick your client, elige tu cliente y copia el snippet listo para pegar:

Herramientas expuestas al cliente MCP: list_collections, get_tree, read_request, create_request, update_request, delete_request, create_folder, send_request, run_collection, get_console, get_docs.

run_collection corre una colección completa (o un folder) con el motor del Runner — ambiente activo por defecto, data file, iteraciones y workers — y le devuelve a la IA un resumen más solo los requests que fallaron (status, error, tests fallidos y el inicio del body). Admite bail (parar en el primer fallo), includePassed (listar también los que pasaron) y timeoutMs (por defecto 5 min). No necesita tener instalado restruno-cli.

Ejemplos de uso (desde tu IA)

Con el cliente conectado, pídele cosas como:

• "Lista mis colecciones de RestRuno y muéstrame el árbol de la colección pagos."
• "Crea en pagos un request POST a {{baseUrl}}/refunds con este body JSON y envíalo; dime el status y el body de respuesta."
• "Envía el request login, y con lo que veas en la consola dime por qué está fallando."
• "Corre el folder smoke con el ambiente staging y 4 workers, y explícame por qué falló cada request."
• "Corre la colección pagos con usuarios.csv; si algo falla, revisa el request y corrígelo."

API REST (alternativa sin MCP)

Llamadas HTTP planas a http://127.0.0.1:<puerto>/api/* con Authorization: Bearer <token> — útil para scripts o CI local:

# listar colecciones (devuelve name + rootPath de cada una)
curl http://127.0.0.1:<puerto>/api/collections -H "Authorization: Bearer <token>"

# árbol de una colección
curl "http://127.0.0.1:<puerto>/api/tree?rootPath=/ruta/a/pagos" -H "Authorization: Bearer <token>"

# enviar un request existente (ruta absoluta) con un ambiente, y leer el response
curl -X POST http://127.0.0.1:<puerto>/api/send \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"requestPath": "/ruta/a/pagos/login.rr.json", "environmentName": "dev"}'

# correr un folder con 4 workers y recibir el resumen + los fallos
curl -X POST http://127.0.0.1:<puerto>/api/run \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"rootPath": "/ruta/a/pagos", "folderPath": "/ruta/a/pagos/smoke", "environmentName": "staging", "workers": 4}'

# leer la consola (últimas 20 entradas)
curl "http://127.0.0.1:<puerto>/api/console?limit=20" -H "Authorization: Bearer <token>"

Endpoints: GET /api/health · GET /api/collections · GET /api/tree?rootPath= · GET|POST|PATCH|DELETE /api/request · POST /api/folder · POST /api/send · POST /api/run · GET /api/console?limit=.

Cookies de sesión

Las respuestas con Set-Cookie se recuerdan solo en memoria (nunca en disco) y se reenvían a peticiones del mismo host — así funcionan los flujos de login. En Globals puedes desactivarlas o limpiarlas. No se almacena caché HTTP.

¿Dónde se guarda todo?

Atajos

Ctrl+Enter enviar · Ctrl+S guardar · Ctrl+T nueva petición (borrador) · Ctrl+W cerrar tab · Ctrl+B mostrar/ocultar panel lateral