Docs

Everything AgentMeter does, command by command. If it's your first time, agentmeter setup is all you need; come back here when you want to fine-tune something.

Install

You need Node.js 18 or newer and git. Reading Cursor or OpenCode needs Node 22.13 or newer, because they store their sessions in SQLite.

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

To update, run the same command. To check the version: agentmeter help. The CLI itself speaks Spanish for now; the reports and the client portal can be in English.

First steps

Configuration

AgentMeter reads agentmeter.config.json in the folder where you run it, or the file you pass with --config. A full example:

{
  "author": "Andes Studio",
  "lang": "en",
  "idleMinutes": 15,
  "brand": {
    "color": "#5b45ff",
    "logo": "./logo.svg"
  },
  "privacy": {
    "hideCommitMessages": false,
    "hideAuthors": false,
    "redact": ["secret-project"]
  },
  "billing": {
    "currency": "USD",
    "mode": "none",
    "aiCost": "include",
    "aiMarkupPercent": 15,
    "taxPercent": 0,
    "dueDays": 15
  },
  "payment": {
    "methods": [
      { "type": "link", "label": "Pay by card", "url": "https://pay.example.com/acme" },
      { "type": "bank", "label": "Wire transfer", "details": "Example Bank · 000-123456" },
      { "type": "qr", "label": "QR code", "image": "./qr.png" }
    ]
  },
  "agents": { "claude": "~/.claude/projects", "cursor": false },
  "clients": [
    {
      "slug": "brightside",
      "name": "Brightside Labs Inc.",
      "paths": ["~/projects/brightside-app"],
      "junit": ["~/projects/brightside-app/reports/junit.xml"],
      "billing": { "mode": "hourly", "rate": 45 }
    },
    {
      "slug": "tienda",
      "name": "Tienda Andina S.R.L.",
      "lang": "es",
      "paths": ["~/projects/tienda-web"],
      "billing": { "currency": "BOB", "usdRate": 6.96, "mode": "fixed", "rate": 4500 }
    }
  ]
}

Reports

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

The report is a single .html file that works offline. It carries the data, your signature and, if you timestamped it, the server's seal. Send it by email or chat like any other file.

Supported agents

AgentMeter reads the logs each agent already keeps on your machine. It doesn't install anything in them or intercept your traffic.

AI cost is computed with each model's public prices (Claude, GPT, Gemini, GLM and others). If the agent reports its own cost and the model isn't in the table, that value is used. It's a reference estimate, not your provider's invoice.

Invoicing and brand

The billing block adds an invoice section to the report with total, taxes and due date.

In payment.methods you list how you get paid: link (https links only), bank (text with your details) or qr (a PNG, JPG or WebP image). They are signed inside the report: if someone swaps your account for theirs, verification fails.

In brand you set your color (#RRGGBB) and your logo (PNG, JPG, WebP or SVG up to 150 KB; SVGs with scripts are rejected). They appear on the report and, on paid plans, on the portal.

Report privacy

• privacy.hideCommitMessages: hides commit messages and keeps only date and changes.
• privacy.hideAuthors: hides who made each commit.
• privacy.redact: list of words or regular expressions replaced across the whole report.

On top of that, before signing, AgentMeter automatically removes anything that looks like a secret: Anthropic, OpenAI, GitHub, AWS, Stripe and Slack keys, JWT tokens, private keys, URLs with passwords and assignments like password=. The command summary tells you how many it found.

Verify a report

Anyone can check a report, no account needed: by dropping it on agentmeter.si or with the CLI.

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

Verification rebuilds the report from its data and compares it byte for byte with what you see, checks the issuer signature and, if it has a timestamp, the server signature. --key requires the issuer fingerprint to be the one you expect. --online also confirms that the timestamp is in the public log.

Timestamps and public log

The signature proves who made the report. The timestamp proves when it existed. When timestamping, the CLI sends only the report's SHA-256 fingerprint and your signature; the server writes it into a chained log, where each entry includes the fingerprint of the previous one, and signs it with its key. Nobody, not even AgentMeter, can insert or delete old entries without breaking the chain.

agentmeter audit

Downloads the full log and checks every link and every signature.

Client portal

With a paid plan you can publish a timestamped report on a private link. Your client opens it, reviews it, approves it or asks for changes, and lets you know when they paid. The portal is shown in the report's language.

Publishing does upload the report (not your code) so the client can see it. Anyone with the link can open it; share it only with your client.

Account and key

Your account is an Ed25519 key created on your machine. There's no user password on the server: you identify yourself by signing with your key.

Profile and domain

agentmeter profile --handle andes-studio --public --headline "Web development with agents"
agentmeter domain add andesstudio.com
agentmeter domain verify andesstudio.com

The public profile shows how many timestamped, approved and paid deliveries you have, at agentmeter.si/p/your-name, with a badge for your website. The domain is verified with a TXT record at _agentmeter.yourdomain.com. After that, your profile and portal show your verified domain next to your fingerprint.

Teams and dashboard

With the Agency plan (up to 5 people) or Enterprise, the owner invites the team and everyone shares the plan and domain.

The dashboard only receives summary numbers from each timestamped report: project, period, commits, lines, tests, minutes, sessions, cost and models. Never code or messages.

Plans and payments

agentmeter upgrade --plan pro --open

Plans: pro, founder and agency. The secure Polar checkout opens and the plan activates within seconds. Polar acts as merchant of record: it issues the receipt and collects any applicable taxes. For the Enterprise plan, write to [email protected].

Environment variables

Generic log format

If you use an agent AgentMeter doesn't read yet, write its events to .jsonl files inside ~/.agentmeter/logs, one JSON line per event:

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

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

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

Required fields: ts and session. Types: prompt, request (with tokens) and tool (with a file, to attribute commits to the agent). cwd links the session to the client's project.

Security

• Reports signed with Ed25519 over the SHA-256 of canonical JSON.
• Private key kept only on your machine, optionally encrypted.
• The CLI pins the server public key on your first sign-up and warns you if it changes.
• The CLI only talks to the server over https.
• Published reports are shown sandboxed, without scripts.

If you find a vulnerability, email [email protected] before disclosing it. We reply within 72 hours and credit you if you like.