Launch and track cloud agent runs

Cloud agents are autonomous workers an admin configured in Agents → Agent Templates. The project's Agents page (/agents in the sidebar) is where you launch them on this project and follow their progress. Each launch creates a run with its own log.

Connect git first

The page is gated on git. If no remote is configured, you see Connect a Git repository first with a three-step guide and a Configure Git repository button that takes you straight to Settings → Git Repository.

Connect a remote there, then come back. Agents need to push commits to act on your codebase.

The runs table

Once connected, the page shows a table of past runs. Columns:

The header shows a count badge with the total. A refresh icon button reloads the list.

Launch a new run

1. Click Launch agent in the top-right.
2. A dialog opens with the list of agents available for this project.
3. Pick an agent, configure its inputs (if it has any), confirm.
4. The run appears at the top of the table with status Running.

Empty state

If no run has ever been triggered for this project, the table is replaced by No runs yet with the message Launch an agent to analyze this project and a Launch agent call to action.

Drill into a run

Click any row to open the run detail page at /agents/runs/:id. You'll see the full event log, the inputs the run started with, and the final output.