Codex CLI time tracking for client billing
Time Trakkr records how long the Codex CLI works in each of your client repositories, interactive or with codex exec, as agent time for the developer who ran it. It is billed at an agent rate you set, on its own invoice lines, and never at the developer’s own rate.
How it works
- An admin sets it up once. Enable Agent time under Settings → Add-ons and set a default agent rate. Nothing is recorded until there is one.
- Repositories are mapped to projects. Pick each repository, from GitHub or by its address, and the project and task its time belongs to. A repository nobody has mapped sends nothing.
- Each developer installs the plugin. You need Node 20 or later.
codex plugin marketplace add Time-Trakkr/agent-plugins && codex plugin add timetrakkr@timetrakkr
Then start Codex and trust the plugin’s hooks with /hooks: Codex does not run a plugin’s hooks until you have. The first session in a connected repository opens your browser to sign in. - Sessions become agent time. Each session waits in the developer’s pending list on their timesheet. It is accepted by them, or automatically once the day ends unless an admin turns that off, and can be reduced or deleted until it is invoiced.
- Accepted time is billed as agent time. It is billed at the agent rate, on invoice lines labeled (agent time), and counts toward budgets and profitability. It stays out of the developer’s own hours and utilization.
How Codex CLI is measured
- A turn runs from the prompt you submit to the moment Codex stops. Agent time is the sum of the turns, so time between turns is not counted.
- Time Codex spends waiting on a permission prompt is counted, because Codex does not report it reliably enough to leave out.
- Token counts are sent when Codex’s own files can be read, and shown as an estimated token cost. When they cannot be read, the cost says “not captured”, never zero.
- Codex may not print the line that says what a session is tracked to. Run npx @timetrakkr/cli status in the repository to see it.
The Agent work report shows accepted agent hours per person and project, with the estimated token cost beside them.
What it will not do
- Codex cloud tasks. The plugin and your sign-in are on your own machine, so nothing is recorded for them.
- The Codex IDE extension, which does not load plugins.
- Installing it as a Codex plugin has not been tested end to end. What was tested is its hooks loaded into a project.
- It never sends your prompts, the contents of any file, or diffs. The service refuses a report that carries anything beyond the fields the help article lists.
- It records nothing in a repository nobody has mapped to a project, not even the repository’s name.
- It does not let anyone type agent time in by hand. Time you spent yourself is logged as your own time, as usual.
- Token cost is an estimate at list price on the day you look. It is never what you were charged and never on an invoice.
Questions about Codex CLI time tracking
Can Codex CLI time be tracked per client?
Yes. An admin maps each repository to a project and task, and the project belongs to a client. Codex CLI sessions in that repository, interactive or codex exec, are recorded against it as agent time for the developer who ran them.
Is Codex time counted as the developer’s own hours?
No. It appears on the developer’s timesheet on its own row, but it is kept out of their own hours, utilization and capacity. It counts toward project budgets, profitability and invoices.
What rate is Codex time billed at?
An agent rate an admin sets for the workspace, a client or a project, with a separate cost rate. A rule can be limited to one agent host. Codex time is never billed at the developer’s own rate.
Does Time Trakkr see my Codex prompts or code?
No. The plugin sends the session’s times, repository address and branch, model and token counts. Prompts, file contents and diffs are never sent.
Does it track Codex cloud tasks or the Codex IDE extension?
No. Codex cloud tasks run where the plugin is not installed, and the Codex IDE extension does not load plugins. Only the Codex CLI on your own machine is supported.
Read the details
The hours, the invoices, and what they earned
Free for unlimited people. One paid plan, $10 per member per month, when you want HR, scheduling, timesheet approvals, scheduled backups, email from your own domain and scheduled reports.
Start free