Documentation Index
Fetch the complete documentation index at: https://help.gowindmill.com/llms.txt
Use this file to discover all available pages before exploring further.
Benefits of Connecting Codex to Windmill
Connecting Codex to Windmill brings AI coding agent usage directly into stats, performance reviews, and 1:1s — giving managers and engineers visibility into how Codex is being adopted across the team.- Tracks how engineers are using Codex for autonomous coding tasks across different client surfaces
- Surfaces adoption patterns including thread volume, turn depth, and token consumption without self-reporting
- Helps managers understand AI tool usage and coach their teams on effective workflows
- Provides concrete data for performance conversations about productivity and tool adoption
- Syncs automatically — no manual tracking or surveys required
How to Connect Codex
Get your Platform API key from OpenAI
Go to platform.openai.com and generate a Platform API key. You’ll need to be an admin of your OpenAI organization to create API keys.
Find your ChatGPT Workspace ID
In the ChatGPT Admin console, locate your Workspace ID (a UUID). This identifies which workspace Windmill should pull analytics from.
Open the Codex integration in Windmill
In Windmill, navigate to Settings > Integrations, find Codex, and click Connect.
Codex is an account-level integration — an admin connects it once and it covers your entire ChatGPT workspace. Individual users don’t need to connect separately.
Connected Data
When connected, Windmill syncs per-user analytics from Codex’s Enterprise Analytics API. This is usage data — Windmill does not access any code, prompts, conversations, or file content. All stats are broken down by client surface (e.g., Codex in ChatGPT, Codex in an IDE, or other clients) so you can see where your team is using Codex.| Stat | Description | Unit |
|---|---|---|
| Threads | Number of Codex threads created | threads |
| Turns | Number of Codex turns (messages) within threads | turns |
| Credits | Total Codex credits consumed | credits |
| Input Tokens | Total input tokens (cached + uncached) sent to Codex | tokens |
| Output Tokens | Total output tokens generated by Codex | tokens |
| Total Tokens | Total tokens consumed across input and output | tokens |
Visibility and Access
Codex stats in Windmill follow the manager hierarchy visibility model:- Employees can see their own Codex stats
- Managers can see Codex stats for their direct reports and anyone in their reporting chain
- Admins can see Codex stats for everyone in the organization
- Peers cannot see each other’s Codex stats
Permissions
Windmill requests read-only access to Codex’s Enterprise Analytics API.| Permission | Purpose |
|---|---|
| Read user analytics | To sync usage stats per team member into Windmill |
| No access to code or files | Windmill never reads, stores, or accesses any code from Codex |
| No access to prompts or conversations | Windmill does not read thread content — only aggregate usage counts |
| Read-only access | Windmill never modifies anything in Codex or your OpenAI account |
User Matching
Windmill matches Codex users to employees using their email address. If a Codex user’s email matches an employee’s email in Windmill, their stats are automatically attributed to that employee. If you notice stats that aren’t being attributed correctly, check that the email addresses in your ChatGPT workspace match the employee emails in Windmill.FAQs
Do I need a ChatGPT Enterprise or Codex plan?
Do I need a ChatGPT Enterprise or Codex plan?
Yes. Codex’s analytics API is only available on the ChatGPT Enterprise or Codex plan. The integration won’t work with ChatGPT’s free, Plus, or Team plans.
Does Windmill access any code, prompts, or conversations?
Does Windmill access any code, prompts, or conversations?
No. Windmill only reads usage analytics from Codex’s API — thread counts, turn counts, credit consumption, and token usage. Windmill never accesses code, files, prompts, or conversation content.
How often does data sync?
How often does data sync?
Windmill syncs with Codex once per hour. New usage data will appear within an hour of the activity happening in Codex.
Can I see my own Codex stats?
Can I see my own Codex stats?
Yes. Every employee can see their own Codex stats in Windmill.
Can my coworkers see my Codex stats?
Can my coworkers see my Codex stats?
No. Codex stats follow the manager hierarchy — only your manager (and their managers) can see your stats. Peers cannot see each other’s Codex usage data.
Does each engineer need to connect Codex individually?
Does each engineer need to connect Codex individually?
No. Codex is an account-level integration. An admin connects it once using a Platform API key and Workspace ID, and it covers your entire ChatGPT workspace.
What are the different client surfaces in the breakdown?
What are the different client surfaces in the breakdown?
Codex stats are broken down by the client surface where the activity happened — for example, Codex in ChatGPT versus Codex in an IDE integration. This helps you understand where your team is using Codex most.
What happens when an engineer leaves?
What happens when an engineer leaves?
Their historical Codex stats remain for context, but Windmill stops attributing new activity once they are an Archived user.
Why aren't my Codex stats showing up?
Why aren't my Codex stats showing up?
This usually happens when your email in your ChatGPT workspace doesn’t match your email in Windmill. Make sure the email addresses match, or ask an admin to check the user mapping.