Los ajustes antes de la primera petición se aplican a todo el archivo, `###` separa las peticiones, y las directivas pueden repetir, limitar o validar una petición. Más ejemplos aquí: [`_examples/`](https://github.com/unkn0wn-root/resterm/blob/main/_examples).

## CLI

`resterm run` ejecuta archivos `.http` / `.rest` sin abrir la TUI, que es lo que ejecuta CI.```bash
resterm run --request CreateUser requests.http

En la TUI, presiona `g Shift+M` para iniciar el mismo servidor mock desde el workspace.

La [documentación de CLI](https://github.com/unkn0wn-root/resterm/blob/main/docs/cli.md) cubre selectores, formatos de salida y más ejemplos.

## Hoja de referencia del teclado

- Enfoque y diseño de paneles
  - `Tab` / `Shift+Tab`: moverse entre la barra lateral, el editor y la respuesta.
  - `g+r`, `g+i`, `g+p`: saltar a solicitudes, editor o respuesta.
  - `g+h` / `g+l`: redimensionar horizontalmente. Cambia el ancho de la barra lateral cuando esta está enfocada; de lo contrario, la división editor/respuesta.
  - `g+j` / `g+k`: redimensionar la altura del editor/respuesta cuando están apilados, contraer o expandir ramas en el navegador.
  - `g+v` / `g+s`: alternar el panel de respuesta entre diseño en línea y apilado.
  - `g+1`, `g+2`, `g+3`: minimizar o restaurar la barra lateral, el editor y la respuesta.
  - `g+z` / `g+Z`: ampliar el panel enfocado, limpiar la ampliación.
- Entornos y globales
  - `Ctrl+E`: cambiar de entornos.
  - `Ctrl+G`: inspeccionar los globales capturados.
- Ayuda y comandos
  - `?`: abrir el índice de ayuda offline con búsqueda.
  - `K` (modo normal del editor): abrir ayuda para la directiva, plantilla o palabra clave bajo el cursor.
  - `:help <topic>` / `:man <topic>`: abrir un tema integrado; `:docs <topic>` abre el manual completo con versión coincidente.
  - `Ctrl+O`: abrir el popup de archivo/workspace. Escribe para filtrar, desplázate con `Up` / `Down` y usa `Tab` para descender en los directorios.
  - `:`: abrir la línea de comandos. Usa `Up` / `Down` para seleccionar sugerencias, `Tab` para completar una, o `Enter` para aceptar y ejecutar una selección. Argumentos de ruta como `:mock start --source` y `:edit` navegan por el sistema de archivos en el mismo popup.
- Respuestas
  - `Ctrl+V` / `Ctrl+U`: dividir el panel de respuesta para comparación lado a lado.
  - `Ctrl+Shift+C` o `g y` (respuesta enfocada): copiar la pestaña completa de Pretty, Raw o Headers.
  - `g x`: mostrar la vista previa de Explain para la solicitud activa sin enviarla.
  - `g e`: abrir el archivo actual en tu editor externo.

> [!TIP]
> Si solo recuerdas tres atajos:
> - `Ctrl+Enter` envía la solicitud
> - `Tab` / `Shift+Tab` cambia de panel
> - `g+p` salta a la respuesta

## Instalación

**Linux / macOS (Homebrew)**```bash
brew install resterm

or con `wget`:```bash
wget -qO- https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.sh | bash

Los scripts detectan tu arquitectura, descargan la última versión e instalan el binario.

### Instalación manual

> [!NOTE]
> El asistente de instalación manual usa `curl` y `jq`. Instala `jq` con tu gestor de paquetes (`brew install jq`, `sudo apt install jq`, etc.).

**Linux / macOS**```bash
# Detect latest tag
LATEST_TAG=$(curl -fsSL https://api.github.com/repos/unkn0wn-root/resterm/releases/latest | jq -r .tag_name)

# Download the matching binary (Darwin/Linux + amd64/arm64)
curl -fL -o resterm "https://github.com/unkn0wn-root/resterm/releases/download/${LATEST_TAG}/resterm_$(uname -s)_$(uname -m)"

# Make it executable and move it onto your PATH
chmod +x resterm
sudo install -m 0755 resterm /usr/local/bin/resterm

### De la fuente```bash
go install github.com/unkn0wn-root/resterm/cmd/resterm@latest

El primer comando informa si hay una versión más reciente disponible. El segundo la descarga, verifica e instala en su lugar. En Windows, el binario antiguo permanece junto al nuevo como `resterm.exe.old` y se limpia en la siguiente actualización.

## Configuración

- Los entornos son archivos JSON (`resterm.env.json`) que se descubren en el directorio de solicitudes, la raíz del espacio de trabajo o el directorio de trabajo actual (CWD). Un archivo puede definir entornos con nombre o grupos independientes, por ejemplo api, app y credentials, que se combinan en un solo entorno. Los archivos Dotenv (`.env`, `.env.*`) son opcionales mediante `--env-file` y son de un solo espacio de trabajo. Consulte [entornos agrupados](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#grouped-environments) y el ejemplo ejecutable en `_examples/grouped/`.
- La configuración se almacena por sistema operativo y se puede sobrescribir con `RESTERM_CONFIG_DIR`:
  - macOS: `~/Library/Application Support/resterm`
  - Windows: `%APPDATA%\resterm`
  - Linux/Unix: `~/.config/resterm`

## Servidores simulados (Mock Servers)

Puede definir respuestas simuladas en los mismos archivos `.http` que sus solicitudes.

- Haga coincidir las solicitudes entrantes por consulta, cabeceras o cuerpo JSON y luego elija una respuesta con nombre o la predeterminada.
- Devuelva una secuencia de respuestas para pruebas de sondeo y reintentos. Use una ruta, consulta, cabecera o valor de cookie para rastrear cada secuencia por separado.
- Retrase las respuestas una cantidad fija, o asigne a cada solicitud un retraso diferente con `random`, `normal` o `jitter`.
- Construya respuestas a partir de valores de ruta, consulta, cabecera y cuerpo, con generadores para datos dinámicos.
- Verifique los recuentos de llamadas con `@expect` o inspeccione el tráfico recibido desde RestermScript.
- Recarga en caliente de archivos fuente y fixtures, con TLS opcional.

Dos escenarios en una misma ruta:```http
### Payment accepted
# @mock method=POST path=/payments name=accepted default=true latency=150ms
HTTP/1.1 202 Accepted
Content-Type: application/json

{"id":"pay_123","status":"pending"}

### Payment declined
# @mock method=POST path=/payments name=declined
# @match query={"mode":"decline"} headers={"X-Tenant":"demo"} json={"amount":0}
HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json

{"error":"amount must be positive"}

Más en la [referencia de Mock Servers](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#mock-servers), la [guía de CLI de `resterm mock`](https://github.com/unkn0wn-root/resterm/blob/main/docs/cli.md#resterm-mock) y el [ejemplo funcional](https://github.com/unkn0wn-root/resterm/blob/main/_examples/mocks.http).

## Headless

El paquete [`headless`](https://github.com/unkn0wn-root/resterm/blob/main/headless) es la API pública de Go para el mismo motor que impulsa la TUI y la CLI. Úsalo para ejecutar solicitudes, flujos de trabajo, aserciones, comparar ejecuciones y perfiles desde tu propio código Go o CI.

Si prefieres no crear tu propio ejecutor, existe [resterm-runner](https://github.com/unkn0wn-root/resterm-runner).

## Colecciones

Exporta un espacio de trabajo como un paquete compatible con Git e impórtalo en otro. Los paquetes incluyen un `manifest.json` con sumas de verificación, por lo que las importaciones verifican primero la integridad de los archivos. Los valores de entorno se exportan como marcadores de posición `REPLACE_ME`, por lo que los secretos nunca salen de tu máquina.```bash
resterm collection export --workspace ./my-api --out ./shared/my-api-bundle
resterm collection import --in ./shared/my-api-bundle --workspace ./my-local-api

se convierte en esto:```http
### POST https://api.example.com/login
# @auth basic demo secret
POST https://api.example.com/login
Content-Type: application/json

{"user":"demo"}

Aquí tienes la traducción al español del contenido del chunk 41 de 63:

---

**Nota:** El texto original no fue proporcionado en el mensaje. Para traducir el contenido, necesito el texto fuente del chunk 41. Sin embargo, dado que el mensaje indica que el input está vacío o no se incluyó, no puedo generar una traducción. Por favor, proporciona el texto del chunk para poder traducirlo.```http
# @use ./rts/helpers.rts
# @when env.has("feature")
# @assert response.statusCode == 200
GET https://api.example.com/users/{{= vars.get("user") }}
Authorization: {{= helpers.authHeader(vars.get("auth.token")) }}

Ejemplo: [`_examples/oauth2.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/oauth2.http). Consulta la [documentación de OAuth 2.0](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#oauth-20-directive).

### Flujos de trabajo y scripting

Los flujos de trabajo encadenan solicitudes con nombre y pueden elegir el siguiente paso a partir de una respuesta:```http
### Sign in
# @workflow sign-in
# @step Login using=Login
// GetProfile and RefreshToken are request names.
// The first true condition runs the named request.
# @if last.statusCode == 200 run=GetProfile
# @elif last.statusCode == 401 run=RefreshToken
# @else fail="unexpected login response"

Cada ciclo de sondeo recibe su propio presupuesto de reintentos. Ejemplo: [`_examples/polling-retries.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/polling-retries.http). Consulta la [documentación sobre sondeo y reintentos](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#polling-and-retries).

### Comparar ejecuciones

`@compare` ejecuta una solicitud contra al menos dos entornos y utiliza un resultado como referencia:```http
### Compare health
# @compare dev stage prod base=prod
GET {{services.api.base}}/status

Los resultados aparecen en la pestaña Timeline y pueden exportarse a OpenTelemetry. Ejemplo: [`_examples/trace.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/trace.http). Consulta la [documentación de tracing](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#timeline--tracing).

### Streaming (WebSocket y SSE)

`@sse` registra eventos del servidor, mientras que `@websocket` y `@ws` scriptean tramas WebSocket. Ambos producen transcripciones en la pestaña Stream:```http
### Events
# @sse duration=30s idle=10s max-events=5
GET https://api.example.com/events

### Chat
# @websocket idle=3s
# @ws send Hello
# @ws close 1000 done
GET wss://api.example.com/chat

La reflexión del servidor está habilitada por defecto. Los conjuntos de descriptores y las llamadas de streaming también son compatibles. Ejemplo: [`_examples/grpc.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/grpc.http). Consulta la [documentación de gRPC](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#grpc).

### Importación de OpenAPI

Genera solicitudes, mocks o ambos desde un documento OpenAPI local o una URL `http(s)`:```bash
resterm --from-openapi _examples/openapi-spec.yml --http-out api.http --openapi-mode both

Perfiles pueden ser de todo el archivo o de todo el espacio de trabajo, y también se admiten túneles en línea de una sola vez. Ejemplo: [`_examples/ssh.http`](https://github.com/unkn0wn-root/resterm/blob/main/_examples/ssh.http). Consulta la [documentación de SSH](https://github.com/unkn0wn-root/resterm/blob/main/docs/resterm.md#ssh-tunnels).

### Reenvíos de puertos de Kubernetes

`@k8s` abre un reenvío de puertos gestionado a un pod, servicio, deployment o statefulset:```http
### Service health
# @k8s namespace=default service=api port=http
GET http://api.default.svc.cluster.local/health