Waybill

Trae recibos. Waybill es una contabilidad de tokens para el trabajo asistido por IA: un plugin para Claude Code que mide cada token, lo atribuye a la historia de Jira que entregó y convierte los recibos en informes de valor, paquetes de revisión de desempeño y solicitudes de presupuesto de tokens que resisten el escrutinio.

Un waybill (conocimiento de embarque) es el documento de envío que detalla la carga y sus costes. Tú envías; Waybill mantiene el registro detallado.

Por qué

Dos conversaciones deciden gran parte del año de un ingeniero, y ambas se basan en la misma información defectuosa:

• "¿Valió la pena el presupuesto de IA?" — cada vez más equipos asignan tokens de Claude según el valor demostrado. Úsalos bien, muéstralo, consigue más.

• "¿Qué lograste este ciclo?" — revisiones de desempeño, paquetes de promoción, revisiones de sprint.

Los humanos responden ambas de memoria, la noche anterior, con adjetivos. Quien decide no puede distinguir afirmaciones honestas de infladas, así que descuenta todo. Waybill arregla la evidencia, no la persuasión: registra el trabajo a medida que ocurre, vincula cada afirmación a un artefacto (un PR, un issue, una etiqueta de despliegue, una transcripción) y se niega a dejar que hagas el tipo de afirmación que hará que tu próximo planteamiento sea ignorado.

Related MCP server: Token Analyzer MCP

Sesenta segundos para tu primer recibo

claude plugin marketplace add Jakeintech/waybill
claude plugin install waybill@waybill

Luego, en una sesión de Claude Code, di "inicializa mi libro contable de waybill". Eso es toda la configuración: sin cuentas, sin tokens, sin OAuth. Waybill siembra tu identidad desde git config, importa las tarifas de lista de precios de Anthropic para que los costes aparezcan desde el día uno, verifica tu configuración de retención de transcripciones y renderiza un recibo de arranque solo con tu historial local de git — tu trabajo entregado, detallado, en menos de un minuto.

Actualización

Claude Code no envía notificaciones de actualización de plugins; la actualización es un solo comando cuando quieras:

claude plugin update waybill@waybill

Luego reinicia Claude Code. waybill status (o waybill --version) muestra la versión del motor que estás ejecutando. Waybill nunca busca actualizaciones por su cuenta — sin llamadas de red sin que tú lo pidas es un compromiso, no un descuido. Los lanzamientos y registros de cambios están en la página de lanzamientos; observa el repositorio (Watch → Custom → Releases) si quieres que GitHub te envíe un correo.

La ruta de actualización (opcional, cinco minutos)

Conectar tu gestor de tareas y tu host de git convierte los commits en recibos con puntos de historia, épicas y marcas de tiempo de fusión:

# Easiest — reuse your authenticated gh CLI:
export GITHUB_MCP_PAT="$(gh auth token)"
# Or mint a fine-grained read-only PAT (repos/PRs) at
# https://github.com/settings/personal-access-tokens and export it instead.

1. /mcp → completa el flujo OAuth para atlassian (no se necesita token).

2. Di "sincroniza mi libro contable y dame un informe de arranque."

¿No sabes qué está o no conectado? waybill status lo dice e imprime el comando exacto para arreglar lo que falte.

Esto importa tus últimos ~90 días de tus propios issues y PRs fusionados y produce un informe solo con hechos — elementos enviados, puntos, PRs, despliegues — antes de que hayas cambiado un solo hábito. A partir de ahí, abrir tareas a través del libro contable desbloquea las afirmaciones más sólidas (ver niveles a continuación).

Cómo funciona

Cada token de Claude Code se mide de forma determinista a partir de tus transcripciones locales y se atribuye a la historia a la que sirvió, con un nombre de solucionador y confianza por evento, una comprobación de conservación (Σ atribuido = Σ observado, por sesión) que puedes volver a ejecutar sin conexión con waybill verify, una bandeja de atribución para los sobrantes ambiguos y diagnósticos de desperdicio por historia (qué compraron los tokens — y qué desperdiciaron en bucles de reintento). A partir de 1.0, el esquema está congelado: los recibos son el contrato.

Niveles de evidencia (la idea central)

Cada número en un informe indica de dónde proviene:

1. Hechos — marcas de tiempo de fusión, etiquetas de despliegue, puntos de historia, recuentos de tokens.

2. Deltas de línea base — tu propia velocidad/tiempo de ciclo antes de Claude vs. ahora.

3. Estimaciones pre-registradas — registradas antes del trabajo, informadas como rangos.

4. Juicio retrospectivo — mantenido en el libro contable, excluido de los planteamientos por defecto.

Además, honestidad estructural: almacenamiento de solo anexión (las correcciones sustituyen, nunca sobrescriben), los rangos nunca se colapsan a puntos medios, el valor cuenta solo cuando se fusiona o despliega, y los costes (tokens gastados, retrabajo) aparecen en cada planteamiento. Reglas completas: metodología.

Plantillas de informes

• token-pitch — la solicitud, los recibos, el libro de gastos, la tendencia de eficiencia, la previsión.

• perf-review — resultados a nivel de épica para un período de revisión, incluyendo trabajo de revisión/incidentes/documentación.

• sprint-recap / quarterly — el registro continuo.

Los informes se renderizan en tres niveles de audiencia — self, internal, external — con seudonimización determinista antes de que nada salga de la organización.

Lo que Waybill nunca hará

• Sin modo jefe, sin vigilancia. Consulta solo tus issues asignados y tus PRs creados.

• Sin comparación entre pares. La metodología rechaza las comparaciones con colegas individuales por diseño — compites contra tu propia línea base, no contra David.

• Sin servicio alojado, sin telemetría. Todo vive en ~/.waybill/ (un repositorio git local que te pertenece).

• Sin seguimiento de tiempo. Registra resultados y estimaciones, no pulsaciones de teclas.

Estos son compromisos, no carencias. Consulta ROADMAP.md.

Pausar, silenciar, irse

La confianza en una herramienta que registra tu trabajo incluye saber exactamente cómo detenerla. El camino completo de salida, desde reducir su actividad hasta irte:

• Pausar la medición (compromiso con el cliente, máquina compartida, depuración): establece "metering": { "enabled": false } en ~/.waybill/config.json. No se captura ni mide nada mientras está en pausa — waybill status informa metering: PAUSED para que el estado nunca sea silencioso. Los datos existentes no se tocan; vuelve a activarlo para reanudar.

• Reducir las notificaciones: "notices": { "level": "minimal" } mantiene solo las líneas de umbral de presupuesto ("off" silencia todo lo que Waybill diga sin que se le pida — la medición sigue funcionando). El recordatorio de renovación (budgets.renewal_reminder_days, predeterminado 14) obedece al mismo interruptor.

• Llevarte tus datos: waybill export --format json (o csv) emite el libro de gastos; todo el libro contable ya es JSONL simple en ~/.waybill/ — un repositorio git local que te pertenece. Cópialo a cualquier lugar; nada es propietario.

• Desinstalar la herramienta, conservar los datos: claude plugin uninstall waybill@waybill, luego reinicia Claude Code. Los hooks y habilidades desaparecen; ~/.waybill/ sigue siendo tuyo.

• Eliminar todo: rm -rf ~/.waybill (o $WAYBILL_HOME si estableciste una). Esa es toda la huella — Waybill no guarda ningún otro estado. Las transcripciones de sesión en ~/.claude/ pertenecen a Claude Code, no a Waybill, y se rigen por su configuración cleanupPeriodDays.

Comparado con las alternativas

Documentación

• Tutorial: el inicio rápido de este README, arriba.

• Cómo hacer: cambiar Jira/GitHub por Linear, GitLab, Bitbucket…

• Referencia: esquema de entrada del libro contable y configuración · referencia de habilidades · plan de pruebas — los documentos que Claude lee son los documentos que tú lees.

• Explicación: metodología de medición de valor · hoja de ruta y alcance · marca y voz · congelación de esquema y política de migración

• Especificación: especificación completa del producto — el diseño normativo que implementa el motor entregado.

Preguntas frecuentes

¿Funciona sin Jira o GitHub? Sí — ese es el valor predeterminado. El modo solo git necesita configuración cero y autenticación cero: la medición, la atribución por rama/pin y el recibo de arranque se ejecutan solo con datos locales. Conectar un gestor de tareas/host de git mejora los recibos; cualquiera que tenga un servidor MCP se puede intercambiar (adaptadores).

¿Puedo usar esto para revisiones de desempeño si mi empresa no raciona los tokens? Sí — esa es la plantilla perf-review. El planteamiento de tokens es una salida del libro contable, no su objetivo.

¿Mis datos son privados? JSONL local en tu directorio personal; las únicas llamadas de red son las llamadas MCP que autorizas, limitadas a tus propios elementos.

¿Por qué no me compara con compañeros? Los puntos de historia no son comparables entre personas, rastrear a colegas se percibe como vigilancia, y tu propia trayectoria es evidencia más sólida de todos modos. (metodología §6)

¿Cómo justifico el gasto en IA a mi jefe? Ejecuta sync, luego "construye mi planteamiento de tokens". Lleva la página única; conserva el libro contable para las preguntas de seguimiento.

Contribuir

Las issues y PRs son bienvenidos — consulta CONTRIBUTING.md, la hoja de ruta y las issues etiquetadas con good first receipt. Las configuraciones de adaptadores para otros gestores de tareas son la contribución más deseada. Por favor, lee el Código de Conducta; los informes de seguridad se envían a través de SECURITY.md.

Licencia

MIT