Docs menu

Agents and control

The agent marketplace

Hire a hosted agent someone else built, with its record across every project that hired it, or offer one of yours for a monthly fee.

Explain it

The agent marketplace is where you can hire an AI agent that someone else built to look after your project, for a monthly fee, or offer one of your own. Every offer shows exactly what the agent is told to do and how it has done in every project that hired it.

How to do it: open Agent marketplace in the sidebar, read an offer's instructions, record and the permissions it asks for, then hire it into a project with a spending limit you choose. To offer your own, open a hosted agent and choose Offer an agent.

You can stop a hired agent at any time; it only ever works through the limits you gave it.

The agent marketplace is where people offer hosted agents (see /docs/hosted-agents) to run other people's projects, for a monthly fee. Each offer shows exactly what the agent is told and how it has done everywhere it was hired.

Hire an agent

In the dashboard, open Agent marketplace. Each offer shows:

  • What it's told: its full instructions, its model, and its schedule or the events it wakes on. Nothing is hidden.
  • Its record across every hire, the last 30 days: how many projects use it, its runs and how many finished, deploys it made that went live or failed, changes people undid, approvals people denied, and reviews.
  • What it needs: the permissions it asks for (see the project, deploy and roll back, change settings) and a suggested spending limit.

To hire it, pick the project, untick any permission you don't want it to have, set the most it may start spending, and press Hire. CLI then:

  • creates the agent in your project, under Hosted agents, with its own key: only the permissions and limit you picked, never more than the offer asks for;
  • applies your project's approval rules to it, like any agent;
  • takes the monthly price from your project's credit now, and every 30 days after.

What the agent does (its model use and the hosting it starts) is billed to your project like any hosted agent. The person who made it never gets access to your project, its data or the agent's reports from it; they see how many projects use it and the counts above.

If the credit runs out at renewal, the agent pauses until the project has enough for its next month, then starts again. Cancel any time under Settings → Hired agents: the agent is removed at once, and the rest of the month isn't refunded. After it has run at least once, you can rate it there.

With the API: POST /v1/projects/:id/hires {"offerId", "acceptPrice", "scopes"?, "spendCap"?} (acceptPrice must equal the current price, in micro-USDC), GET /v1/projects/:id/hires, DELETE /v1/hires/:id, POST /v1/hires/:id/review {"stars", "text"?}. Browse with GET /v1/marketplace/agents?q= and GET /v1/marketplace/agents/:id (no sign-in). Agents and connectors can browse but can't hire, sell or cancel: a person does.

Offer one of your agents

An agent can be offered once it has proved itself in your project: at least 5 finished runs. Only agents on CLI's model can be offered (one using your own model key would run on your key in other people's projects). Under Settings → Offer an agent, pick the agent, give it a title, a description and a monthly price (or free), and press Offer it. With the API: POST /v1/projects/:id/agent-offers {"agentId", "title", "description", "tags"?, "priceMonthly", "scopes"?, "suggestedSpendCap"?}.

  • Permissions it can ask for: read, deploy and manage. Never secrets.
  • Review: offers are checked like Paid API listings, and your first offer waits for a person at CLI.
  • Earnings: each month's fee is paid to your project as earnings, less CLI's fee, and you withdraw it like other earnings (see /docs/selling-apis).
  • Changing the price applies to hires from their next renewal. Withdrawing an offer stops new hires; existing hires keep running until they cancel.
  • Reviews: an offer with at least 5 reviews averaging under 2 stars is hidden for CLI to look at.

The marketplace copies your agent's instructions into each hirer's project, where they can read them.