rollout-v2.3.md — httui

httui

acme payments rollout-v2.3.md

local

staging

prod

Search blocks, vars, schema… ⌘K

RMT

main

Run all

Files

runbooks

payments

rollout-v2.3.md

rollback.md

incident-2026-03-19.md

onboarding

data-fixes.md

scratch

ad-hoc.md

shared / team

Connections

pg · payments@staging 18ms

pg · payments@prod PROD 41ms

mongo · audit 22ms

redis · cache 88ms

API · payments 142ms

Variables — staging

BASE_URL https://api.staging.acme.dev

TENANT_ID tnt_8f2a91

ADMIN_TOKEN ••••••••••••mB9k

PG_DSN postgres://app@db-staging…

rollout-v2.3.md

rollback.md

ad-hoc.md

runbooks / payments / rollout-v2.3.md · edited há 4 min by rafael 10 blocks · 4 ran · 1 pending · auto-capture

runbooks / payments / rollout-v2.3.md draft · 4 unsaved edits

Rollout — Payments v2.3 → staging

R rafael · edited há 4 min · 10 blocks · main +3 ~1 · last run 14:23 — all green

Deploy do novo provider de cartão (stripe_v2) para o tenant acme-payments em staging. Antes de promover para prod, validar que a config foi propagada, que payments_route não tem rotas órfãs, e que a latência do stream de captura fica abaixo de 800ms.

PRÉ-FLIGHT — 4 itens

config do tenant atualizada em tenants.config

0 registros órfãos em payments_route

subscrever stream WS por 30s

rollout_pct ≤ 25 antes de prod

Markdown que se ejecuta.

Cada bloque es ejecutable: peticiones HTTP y consultas SQL (PostgreSQL, MySQL, SQLite). Las capturas de un bloque se vuelven variables del siguiente, encadenando todo el flujo dentro de un único .md.

— Capturas encadenadas — reutiliza un valor de una respuesta como {{login.body.token}} en el siguiente bloque.
— Aserciones — una sección # expect: con líneas como time < 500ms hace fallar el runbook en regresión.
— Variables y secretos referenciados por clave. El valor nunca toca git.

1. Verify shadow traffic

Confirm payments-router is mirroring 5% of requests in staging.

POST {{api}}/v2/payments ● 201 · 218ms

{

"id": "pay_01H8XK...",

"provider": "stripe_v2",

"shadow": true

}

captured: payment_id = pay_01H8XK…

SQL pg · payments@staging ● 1 row · 14ms

SELECT status, provider FROM payments

WHERE id = {{payment_id}}

Nativo de base de datos

Schema explorer junto al editor.

Conecta PostgreSQL, MySQL y SQLite. Navega tablas con foreign keys, índices y row count. EXPLAIN ANALYZE en forma de árbol muestra dónde gasta tiempo tu query.

— Multi-base de datos en un único runbook — consulta PostgreSQL y luego MySQL sin cambiar de ventana.
— Mutation guard — SQL destructivo (UPDATE / DELETE) avisa antes de correr.
— EXPLAIN ANALYZE en forma de árbol, con seq scans lentos resaltados.

SCHEMA · payments

▾ public 4 tables

▸ payments 84.2k

▾ payments_route 4.3k

id uuid

provider_key text

tenant_id uuid

active bool

created_at timestamptz

▸ payment_provider 12

▸ tenants 284

▾ analytics 1 table

▸ events 12.4M

Result · 3 rows · 14ms EXPLAIN

#	id	provider_key	tenant	active	created_at
1	rt_4f2a	stripe_v2	acme	true	2026-04-24 14:08
2	rt_7ce1	stripe_v2	acme	true	2026-04-24 13:51
3	rt_b08d	adyen_v1	acme	false	2026-04-23 09:12

EXPLAIN ANALYZE

↳ Index Scan using idx_route_provider · 0.42..18.7 · 3 rows · 0.21ms

Nativo de git · diffeable

Versionado. Revisable. Compartible.

Los runbooks son .md en tu repo. Revisión por pull request como cualquier código. Diff entre runs muestra qué cambió en la respuesta.

— Code review de runbooks en GitHub o GitLab.
— Diff entre runs — compara la ejecución de hoy con la de ayer en dos clicks.
— Comparte la URL del repo — HTTPS, SSH o web — para cualquier runbook en un click.

main · 3 changes · runbooks/payments/rollout-v2.3.md +18 −4

@@ -42,7 +42,11 @@ ## 3. Verify latency

- ```http GET {{api}}/v2/health

- expect: status === 200

- ```

+ ```http POST {{api}}/v2/payments

+ Authorization: Bearer {{user_token}}

+ Content-Type: application/json

+ { "amount": 1200, "currency": "BRL" }

+ expect: status === 201

+ expect: time < 500ms

+ capture: payment_id = $.id

+ ```

httui-lang · LSP

Úsalo en cualquier lugar.

El formato de los bloques .httui es un lenguaje de verdad con grammar tree-sitter y servidor LSP. Los runbooks reciben autocomplete, hover y go-to-definition de referencias — dentro de cualquier editor que hable LSP.

VS CodeNeovimZedHelixIntelliJSublime

Integrado en el app de escritorio · binario standalone para terminales · publica la grammar en cualquier registry de paquetes.

smoke-test.httui

# Smoke test
http alias=login timeout=5000
POST https://api.example.com/auth/login
Content-Type: application/json

{ "user": "alice", "pwd": "{{SECRET}}" }

http alias=me
GET https://api.example.com/me
Authorization: Bearer {{login.body.token}}

# expect:
#   status == 200
#   time < 500ms

Instalar

Gratis para siempre. Tuyo para hacer fork.

Una línea. Sin registro, sin tarjeta, sin telemetría.

~/projects · zsh

$ curl -fsSL https://httui.com/install.sh | sh

✓ descargando la última release…

✓ httui instalado → /Applications/httui.app

$ open /Applications/httui.app

Homebrew

brew tap httuicom/httui

brew install --cask httui

▣ GitHub Releases

.dmg · .msi · .exe

.deb · .rpm · .AppImage

{ } Desde el código

make install-deps

cargo tauri build

Builds GUI para macOS · Linux · Windows en GitHub releases. El build de macOS no está firmado — el script de install y el cask de Homebrew limpian la cuarentena de Gatekeeper; el auto-update interno lo mantiene actualizado.

Depura tus APIs y bases de datos en un único archivo markdown.

Rollout — Payments v2.3 → staging

Markdown que se ejecuta.

Schema explorer junto al editor.

Versionado. Revisable. Compartible.

Úsalo en cualquier lugar.

Gratis para siempre. Tuyo para hacer fork.

Deja de depurar en cinco pestañas.
Empieza a escribir runbooks en su lugar.

Depura tus APIs y bases de datos en un único archivo markdown.

Rollout — Payments v2.3 → staging

Markdown que se ejecuta.

Schema explorer junto al editor.

Versionado. Revisable. Compartible.

Úsalo en cualquier lugar.

Deja de depurar en cinco pestañas. Empieza a escribir runbooks en su lugar.

Deja de depurar en cinco pestañas.
Empieza a escribir runbooks en su lugar.