Skip to main content

Cursor integration: set up and troubleshoot

Cursor has two actions. Launch Background Agent launches a Cursor Background Agent to work on a repository with a prompt.

Written by Umer Ishaq

Cursor has two actions. Launch Background Agent launches a Cursor Background Agent to work on a repository with a prompt. Check Background Agent Status checks the status of an agent by its ID. Both run on your own Cursor account.

Before you start

  • Account: your own Cursor account. Nothing is charged from your wallet. Connect it first (steps below).

  • Input: it depends on the action. Each action below says what the row needs.

  • Important: Launch Background Agent writes outside Loopster. With Auto-run on, new values in the first column trigger the row workflow, so data can be sent without you clicking run. Add the column without running it and test one row first. See Run columns safely: Auto-run, test one row, then run the rest.

How do I connect Cursor?

  1. Open Settings, then Connections.

  2. Click Create.

  3. In the Connect an account window, find Cursor in the list and click it.

  4. Follow the steps that open for Cursor.

Then open the column's settings: the Account block shows which account the column uses, with a Manage accounts link. See Connections: Loopster-provided accounts and your own.

How do I use Cursor in a table?

  1. Click Add column, then Add enrichment.

  2. Open the Export tab. Under Automation, open Cursor. It shows "2 actions".

  3. Choose the action you want. The list below says what each one does and what it needs.

  4. For Launch Background Agent, write the prompt and enter the repository. The branch or ref starts as main. For Check Background Agent Status, map the column that holds the agent ID.

  5. Click the arrow next to the main button and choose Add column without running.

  6. Click the play button on one row, then double-click the cell to read the result.

  7. Check the result in Cursor too.

  8. To run the rest, click the play button on the column header and choose Run all N empty rows in the Run column dialog.

The Add column panel searching for Cursor, with the Cursor entry expanded: 2 actions, runs on your Cursor account. Push to Cursor lists Launch Background Agent, and Look up in Cursor lists Check Background Agent Status.

What can Cursor do in Loopster?

  • Launch Background Agent (Export tab): Launch a Cursor Background Agent to work on a repository with a prompt. No input needed from the row.

  • Check Background Agent Status (Export tab): Check the status of a Cursor Background Agent by its ID. Input: the agent's ID.

How do I check it worked?

  1. Double-click a cell.

  2. The details show the fields of the result. Hover a field and click Add to column to put it in its own column. See Put a result's fields into their own columns.

  3. Also check the result in Cursor.

Troubleshooting

Quick answer

  1. Auto-run is off, or the column was added without running.

  2. A required input or setting has no value (the panel footer warns).

  3. The cell says Error: open it and read the message. Then check the Cursor connection under Settings, then Connections.

Nothing happens, or the cells stay empty

What you see: The column exists, but no row has run.

Why it happens: Auto-run is Off (the app says "New rows and values will not run on their own"), or you chose Add column without running.

What to do: Click a row's play button, or use the column header's Run column dialog. See Why didn't my column run?.

The footer says "Select a column for … before running"

What you see: A warning such as "Select a column for … before running." in the panel footer.

Why it happens: A required input or setting (marked with *) has no value. An input can be empty even when a suggestion names a column.

What to do: Click the input, press / and pick a column from the list. Do not close the list with Esc: a / or @ is then left in the field as plain text.

My cells say Skipped

What you see: Skipped in the cells.

Why it happens: Skipped means "Did not run because of filters or missing dependencies."

What to do: Double-click the cell and read the message. Check that every input is mapped to a column, and look under Run Settings for Add run condition ("Only run if this formula resolves to true.").

My cells say Unsatisfied

What you see: Unsatisfied in the cells.

Why it happens: Unsatisfied means "Enrichment ran correctly, but output didn't match expected format."

What to do: Double-click the cell and read the message. Check the input values in that row, and test one row before you re-run many. See What a cell's message means.

A cell says Error

What you see: The cell says Error, and the footer shows a count such as "1 cell failed".

Why it happens: Error means "Crashed, something went wrong." The message is in the cell it happened in.

What to do: Double-click the cell and read the message. Then open Settings, then Connections, and check the Status of the Cursor connection. Check Cursor before you re-run, because a re-run runs the action again.

I am not sure which Cursor account a column uses

What you see: You want to know which Cursor account a column runs on.

Why it happens: Cursor runs on your own account, and the column's Account block shows which account it uses.

What to do: Open the column's settings and look at the Account block. Its Manage accounts link is next to it. Settings, then Connections, lists every account the workspace can run on. If Cursor is not there, click Create and find Cursor in the list.

The result did not change after I edited an input

What you see: A finished cell keeps its old result after you change an input.

Why it happens: With Auto-run on, Keep existing results is ticked: "Only errored, empty and new cells run. A completed answer is left alone even when one of its inputs changes."

What to do: Double-click the cell and click Re-run this cell, or click the play button on the column header and choose Overwrite all N rows in the Run column dialog. Read the line under each option first. Either one runs the action on Cursor again.

Cursor got the same data twice

What you see: Repeated changes or duplicate entries in Cursor.

Why it happens: This action writes outside Loopster. Re-run this cell and Overwrite all N rows run it again, so Cursor may receive the data again.

What to do: Test one row first and check it in Cursor. Keep Auto-run off until the first row looks right.

Two agents started for one row

What you see: Two agents for one row.

Why it happens: Launch Background Agent writes outside Loopster. Re-run this cell and Overwrite all N rows run it again, so another agent may start.

What to do: Test one row first and check Cursor before you re-run.

What does it cost?

Cursor runs on your own account. Nothing is charged from your wallet. See Your wallet and keeping spend under control.

Good to know

  • Cursor has two actions in Loopster. They are all in the Export tab.

  • No action is marked as eligible for a waterfall step.

  • No action creates rows in your table.

  • Launch Background Agent writes outside Loopster. Check Background Agent Status only reads from your own account.

Did this answer your question?