Agent Registry

The Agent Registry is where you register, view, and manage the AI agents that participate in the development workflow. Unlike initiatives, requirements, and plans (which are read-only in the dashboard), the Agent Registry supports full create, edit, and delete operations directly in the UI.

There is no separate detail page for agents — all viewing, registering, editing, and managing happens through the agents list and its side-panel drawer.

Viewing Agents#

The agents list displays all registered agents in a table with the following columns:

Name — The agent's display name (sortable).
URL — The agent's endpoint URL (truncated in the table — the full URL is visible in the drawer).
Status — The agent's current status, shown as a clickable badge (sortable).
Version — The agent's version number.
Created — When the agent was registered (sortable).
Actions — View, edit, and delete icons.

Capabilities and full agent details are shown in the drawer, not in the list table.

When no agents are registered, the table is replaced by an empty state with a "Register First Agent" button to open the registration drawer.

Viewing Agent Details#

Click the view icon in the actions column to open the agent drawer in read-only mode.

The drawer shows:

Card URL — The agent's card URL (read-only).
Status — The agent's current status, displayed above the preview card.

Below these fields, a preview card displays the agent's full details:

Name — The agent's display name.
Description — A summary of what the agent does.
Version — The agent's version number.
Agent URL — The agent's endpoint URL.
Protocol version — The protocol version the agent supports.
Capabilities — The agent's supported capabilities.
Skills — The count of skills, plus a list showing each skill's name, description, and tags.
Input/output modes — The supported input and output modes.

All fields are read-only in the view drawer. To make changes, use the edit action instead.

Registering an Agent#

To register a new agent:

Click "Register New Agent" to open the registration drawer.
Enter the Agent Card URL — the URL where the agent's card metadata is hosted.
Click Fetch to retrieve the agent's capabilities from the card URL.
Set the agent's status to active or disabled.
Review the preview card that appears below the status toggle. The preview card shows the agent's name, description, version, agent URL, protocol version, capabilities, skills (count and list with name, description, and tags), and supported input/output modes. Verify this matches the agent you intend to register.
Click Submit to complete the registration.

Editing an Agent#

Click the edit icon in the actions column to open the edit drawer.

In the edit drawer, you can:

Update the Agent Card URL and click Fetch to retrieve updated capabilities. The preview card refreshes to show the new agent details.
Toggle the agent's status between active and disabled.

After making changes, submit the form to save.

Toggling Agent Status#

You can switch an agent between active and disabled states in two ways:

From the list — Click the status badge directly in the agents table. The status toggles immediately.
From the edit drawer — Use the status toggle in the edit drawer and submit to save.

Deleting an Agent#

Click the delete icon in the actions column. A confirmation dialog appears with:

The agent's name in the title (e.g., "Delete MyAgent").
A warning that the action cannot be undone.
Cancel and Delete buttons.

Click Delete to permanently remove the agent, or Cancel to dismiss the dialog.