Documentación

Todo lo que hace AgentMeter, comando por comando. Si es tu primera vez, con agentmeter setup alcanza; vuelve aquí cuando quieras ajustar algo.

Instalar

Necesitas Node.js 18 o más reciente y git. Para leer Cursor u OpenCode hace falta Node 22.13 o más reciente, porque guardan sus sesiones en SQLite.

npm install -g https://agentmeter.si/cli/agentmeter.tgz

Para actualizar, corre el mismo comando. Para comprobar la versión: agentmeter help.

La terminal habla español o inglés y sigue el idioma de tu sistema. Para elegir uno, corre agentmeter lang es o agentmeter lang en. Eso solo cambia la terminal: cada informe tiene su propio idioma (mira Configuración).

Primeros pasos

Configuración

AgentMeter lee agentmeter.config.json en la carpeta donde lo corres, o el archivo que indiques con --config. Un ejemplo completo:

{
  "author": "Cecilia Studio",
  "lang": "es",
  "idleMinutes": 15,
  "brand": {
    "color": "#5b45ff",
    "logo": "./logo.svg"
  },
  "privacy": {
    "hideCommitMessages": false,
    "hideAuthors": false,
    "redact": ["proyecto-secreto"]
  },
  "billing": {
    "currency": "BOB",
    "usdRate": 6.96,
    "mode": "none",
    "aiCost": "include",
    "aiMarkupPercent": 15,
    "taxPercent": 0,
    "dueDays": 15
  },
  "payment": {
    "methods": [
      { "type": "link", "label": "Tarjeta", "url": "https://pagos.ejemplo.com/acme" },
      { "type": "bank", "label": "Transferencia", "details": "Banco Unión · 1-234567" },
      { "type": "qr", "label": "QR", "image": "./qr.png" }
    ]
  },
  "agents": { "claude": "~/.claude/projects", "cursor": false },
  "clients": [
    {
      "slug": "acme",
      "name": "ACME Inc.",
      "paths": ["~/proyectos/acme-web"],
      "junit": ["~/proyectos/acme-web/reports/junit.xml"],
      "billing": { "mode": "fixed", "rate": 4500 }
    },
    {
      "slug": "brightside",
      "name": "Brightside Labs Inc.",
      "lang": "en",
      "paths": ["~/proyectos/brightside-app"],
      "billing": { "currency": "USD", "mode": "hourly", "rate": 45 }
    }
  ]
}

Informes

agentmeter report --client acme --period last-month --open

El informe es un único archivo .html que funciona sin internet. Lleva dentro los datos, tu firma y, si lo sellaste, el sello del servidor. Puedes enviarlo por correo o WhatsApp como cualquier archivo.

Agentes compatibles

AgentMeter lee los registros que cada agente ya guarda en tu computadora. No instala nada en ellos ni intercepta tu tráfico.

El costo de IA se calcula con los precios públicos de cada modelo (Claude, GPT, Gemini, GLM y otros). Si el agente informa su propio costo y el modelo no está en la tabla, se usa ese valor. Es una estimación de referencia, no la factura de tu proveedor.

Cobro y marca

El bloque billing agrega al informe una sección de cobro con total, impuestos y fecha de vencimiento.

En payment.methods pones cómo te pagan: link (solo enlaces https), bank (texto con tus datos) o qr (una imagen PNG, JPG o WebP). Van firmados dentro del informe: si alguien cambia tu cuenta por la suya, la verificación falla.

En brand defines tu color (#RRGGBB) y tu logo (PNG, JPG, WebP o SVG de hasta 150 KB; los SVG con scripts se rechazan). Se usan en el informe y, en planes pagos, en el portal.

Privacidad del informe

• privacy.hideCommitMessages: oculta los mensajes de commit y deja solo fecha y cambios.
• privacy.hideAuthors: oculta los nombres de quienes hicieron cada commit.
• privacy.redact: lista de palabras o expresiones regulares que se reemplazan en todo el informe.

Además, antes de firmar, AgentMeter borra automáticamente lo que parezca un secreto: llaves de Anthropic, OpenAI, GitHub, AWS, Stripe y Slack, tokens JWT, llaves privadas, URLs con contraseña y asignaciones como password=. El resumen del comando te dice cuántos encontró.

Verificar un informe

Cualquiera puede comprobar un informe, sin cuenta: arrastrándolo en agentmeter.si o con el CLI.

agentmeter verify informe.html --key 7FB9-4803-4C89-8F42 --online

La verificación vuelve a generar el informe desde sus datos y lo compara byte por byte con lo que se ve, revisa la firma del emisor y, si tiene sello, la firma del servidor. --key exige que la huella del emisor sea la que esperas. --online confirma además que el sello figura en el registro público.

Sellos y registro público

La firma prueba quién hizo el informe. El sello prueba cuándo existía. Al sellar, el CLI envía solo la huella SHA-256 del informe y tu firma; el servidor la anota en un registro encadenado, donde cada entrada incluye la huella de la anterior, y lo firma con su llave. Nadie, ni siquiera AgentMeter, puede insertar o borrar entradas viejas sin romper la cadena.

agentmeter audit

Descarga el registro completo y comprueba cada eslabón y cada firma.

Portal del cliente

Con un plan pago puedes publicar un informe sellado en un enlace privado. Tu cliente lo abre, lo revisa, lo aprueba o pide cambios, y avisa cuando te pagó.

Al publicar sí subes el informe (no tu código) para que el cliente lo vea. Quien tenga el enlace puede abrirlo; compártelo solo con tu cliente.

Cómo funciona el pago

1. Pones tus medios de pago en payment.methods (enlace, cuenta o QR). Van dentro del informe y quedan firmados.
2. Tu cliente te paga directo con esos medios. AgentMeter no recibe ni retiene ese dinero y no cobra comisión.
3. En el portal, tu cliente pulsa Ya pagué y deja la referencia. Te llega como aviso en agentmeter shares.
4. Cuando ves el dinero en tu cuenta, corres agentmeter paid <portal>. El portal y el panel de tu cliente lo muestran como pagado, y suma a tu perfil público.

Panel del cliente

Tus clientes entran a agentmeter.si/cliente con un código que llega a su correo y ven todas las entregas que recibieron de todos sus proveedores: qué falta aprobar, qué falta pagar y quién tiene dominio verificado. Una entrega aparece en su panel cuando la publicas con su correo, o cuando la aprueba o informa un pago desde el portal.

Cuenta y llave

Tu cuenta es una llave Ed25519 que se crea en tu computadora. No hay contraseña de usuario en el servidor: te identificas firmando con tu llave.

Perfil y dominio

agentmeter profile --handle cecilia-studio --public --headline "Desarrollo web con agentes"
agentmeter domain add ceciliastudio.com
agentmeter domain verify ceciliastudio.com

El perfil público muestra cuántas entregas selladas, aprobadas y pagadas tienes, en agentmeter.si/p/tu-nombre, con una insignia para tu web. El dominio se verifica con un registro TXT en _agentmeter.tudominio.com. Después tu perfil y tu portal muestran tu dominio verificado junto a tu huella.

Equipos y panel

Con el plan Agencia (hasta 5 personas) o Empresa, el dueño invita al equipo y todos comparten plan y dominio.

Al panel solo llegan cifras resumidas de cada informe sellado: proyecto, periodo, commits, líneas, pruebas, minutos, sesiones, costo y modelos. Nunca código ni mensajes.

Planes y pagos

agentmeter upgrade --plan pro --open

Planes: pro, founder y agency. Se abre el pago seguro de Polar; el plan se activa en segundos. Polar actúa como vendedor registrado: emite el recibo y cobra los impuestos que correspondan. Para el plan Empresa, o para pagar por transferencia, escribe a [email protected].

Variables de entorno

Formato genérico de registro

Si usas un agente que AgentMeter todavía no lee, escribe sus eventos en archivos .jsonl dentro de ~/.agentmeter/logs, una línea JSON por evento:

{"ts": "2026-10-10T14:02:11Z", "agent": "mi-agente", "session": "s1", "cwd": "/home/ana/proyectos/acme", "type": "prompt"}

{"ts": "2026-10-10T14:02:30Z", "agent": "mi-agente", "session": "s1", "type": "request", "model": "glm-5", "input": 12000, "cachedInput": 8000, "output": 900}

{"ts": "2026-10-10T14:03:05Z", "agent": "mi-agente", "session": "s1", "type": "tool", "name": "edit", "file": "src/app.js"}

Campos obligatorios: ts y session. Tipos: prompt, request (con tokens) y tool (con archivo, para atribuir commits al agente). cwd relaciona la sesión con el proyecto del cliente.

Seguridad

• Informes firmados con Ed25519 sobre el SHA-256 del JSON canónico.
• Llave privada guardada solo en tu computadora, opcionalmente cifrada.
• El CLI fija la llave pública del servidor en tu primer registro y avisa si cambia.
• El CLI solo habla con el servidor por https.
• Los informes publicados se muestran aislados (sandbox), sin scripts.

Si encuentras una vulnerabilidad, escríbenos a [email protected] antes de publicarla. Respondemos en menos de 72 horas y te damos crédito si quieres.