Agent Inventory is currently in limited beta. Contact Opal support to enable it for your organization.
Requirements
Before you begin, you must:- Be an Opal Admin. A read-only admin can’t import agents.
- Connect your Cursor organization to Opal. See the Cursor integration.
How Cursor agents reach the inventory
There are two ways. Both end with the same result: one agent for each person, named<Name>'s Cursor.
Sync from your Cursor team
An admin runs the sync. Opal creates an agent for each person on your Cursor team whose email matches a person in Opal. Team members with no matching person in Opal are skipped.- Go to Inventory > Agents and select + Agent.
- In Add agents, find your Cursor connection and select Add agents.
- Select Sync.
From tool calls
When tool call governance is set up for Cursor, Opal matches each call to a person. It tries the person’s own sign-in token first, then the emails the computer reports, starting with the email of the account Cursor is signed in with. The call appears on that person’s Cursor agent. A call that matches no agent is unattributed. If the person has no Cursor agent, Opal can create one from their first call. That happens only when your organization has it turned on, and only when the email matches an active person in Opal. Opal doesn’t recreate an agent that an admin deleted. The next sync adopts an agent that a call created, so the person keeps one Cursor agent.What Opal reads
What you see
Go to Inventory > Agents. Filter by Source or Harness and choose Cursor to list your Cursor agents. The Source column names the connection an agent came from, not the word Cursor. An agent that a tool call created has no connection, so it shows a dash until a sync adopts it. A person’s Cursor agent starts with these values:
Open an agent to see its profile. An agent that the sync made for a person also has a Cursor activity tab. It lists each call with When, Tool, and Target, and has three scopes:
- All shows this agent’s calls together with the unattributed ones.
- This agent shows only the calls attributed to it.
- Unattributed shows calls that no agent matched.
What isn’t covered
- Computers that send nothing. Calls reach the inventory only from computers where the hook is installed. A computer that sends nothing looks inactive.
- Who made a call. Opal takes the person from what the computer reports. It’s a label, not proof.
- Windows and Cursor’s cloud agents. The hook doesn’t cover them yet. Their people still get an agent from the sync. See Cursor Setup.