Skip to content

Codex Meter Agent 2.1.0

Choose a tag to compare

@github-actions github-actions released this 04 Sep 11:11
· 7 commits to main since this release

Codex Meter V2.1

V2.1 introduces Account Profiles and declarative Device-to-Agent configuration. Device onboarding now follows the product flow: create a Device, select the Account Profile to track, run the generated bootstrap command, and sign in to Codex only when requested. Manual agent.json editing and manual service restarts are not required.

Highlights

  • One-account onboarding that safely adopts the Device's current Codex login.
  • Isolated multi-account profiles with automatic private CODEX_HOME and launcher creation.
  • Explicit opt-in tracking: only Codex environments the user assigns to Meter Account Profiles are collected.
  • Zero-touch migration of profiles already managed by Codex Meter, preserving launchers, homes, cursors, outbox records, and history.
  • Live declarative configuration apply without an Agent restart, with last-known-good behavior on apply failure.
  • Stop tracking without deleting the Codex login, local data, sessions, launcher, or historical Meter data.
  • Per-Account quota status, quota-cycle attribution, tracking coverage, and estimated quota contribution.
  • Account, Device, and Group usage breakdowns with offline replay and restart preservation.

Privacy and identity

Codex Meter does not automatically identify provider accounts. Users explicitly assign Codex environments to Meter Account Profiles. Unregistered Codex environments are not discovered, inspected, watched, collected, modified, or reported to the Server.

The Server does not receive local CODEX_HOME paths or authentication material. Codex Meter does not read or copy provider credentials and does not sign in on the user's behalf.

Estimated quota contribution is an estimate that allocates provider-reported Account usage in proportion to locally tracked token usage. It is not exact provider-attributed usage.

Validation

  • Linux live onboarding: validated.
  • Windows x64 native build and SEA smoke: validated; Windows live onboarding: NOT TESTED.
  • macOS arm64 native build and SEA smoke: validated; macOS live onboarding: NOT TESTED.
  • Natural provider reset: NOT TESTED. Reset and cycle-boundary behavior is covered by automated boundary tests.
  • Node.js 24.15 full suite: 218/218 passed; V1: 68/68; V2: 150/150; 0 failed; 0 skipped.
  • Independent gpt-5.6-luna review at max reasoning: Critical 0, High 0, Medium 0.