---
lang: en
---

# Connecting from an AI agent

An AI client or agent gets into your team's Cactus account only when you approve it: on the approval page you read what it may do, then select Allow or Deny. An agent with no browser is approved with a six-digit code on the page its link opens.

> Verified against the product on 2026-11-21

## Approve an AI client in your browser

1. Your AI client sends you to the approval page, which asks **Your agent wants to use Cactus as you. Shall I let it in?** When the request asks to set Cactus up, the question reads **Your agent wants to set up Cactus for you. Shall I let it in?**
2. Read the line that says what it will be able to do, in the list under [What the agent may do](#what-the-agent-may-do).
3. Read the line that says where it is from. It shows the host it came from, or **It’s on this computer** for a client on your machine, and the name the client gives itself. Cactus does not check that name.
4. Select **Allow** to let it in, or **Deny** to refuse it. Deny sends the refusal back to the client.

> **Note:** If you are logged out, the page asks you to log in first. **Log in with GitHub** and **Log in with Google** show where those are set up, and the page then returns you to the same request.

If your login runs out while the page is open, the page says **Your login timed out while this page was open.** Select **Log in again** to sign in and return.

## Which team the agent works in

Allow connects the agent to the team the page names in its line about the team. The line changes with your account, and Allow does this for each case:

| The page says | What Allow does |
| --- | --- |
| **It will work in** {team name}**, with your access.** | Connects the agent to your team, and it works with the access you have there. |
| **When you allow, I’ll make** {team name}**, with Pro free until** {day}**. No card.** | Creates a team that you own, on the Pro plan for the free trial, which lasts 14 days. No card is asked for. |
| **Your team, {team name}, is already on Cactus**, with **Join {team name}** | Sends you to join that team first, then returns you to the same request. |
| **Cactus has a waitlist for now. Click Allow to join it.** | Puts you on the waitlist. The client is connected all the same and starts working the day you are let in. |
| **It acts on a Cactus teamspace, and you’re not on one yet.** | Refuses the login if you came through a help site. |

On the waitlist, the page also shows a field for **Or enter referral code**. A code that works lets you in at once, and a code that does not work stops Allow with **That code doesn’t work. Check it and try again.**

The page names a help site's own address when the sign-in came through one, as **It is logging in through** followed by that address.

## What the agent may do

The approval page lists what the client asked for, in these words.

| The page says | What it lets the agent do |
| --- | --- |
| **set up your product, help site, and Messenger** | Create products, connect GitHub and choose which repositories Cactus reads. |
| **read your pages** | Read your team’s help pages, what Cactus has learned about your product from its code, and past conversations with your customers. |
| **ask me questions** | Ask Cactus questions and start investigations. Each one starts a new conversation. |

A client that signs in for one product's address, or through a help site, is given only reading and asking. Setting up is given only on the team address. A client that names no permissions is given all three.

## Connect an agent with no browser

An agent with no browser, such as a command-line tool or a server job, shows you a six-digit code and a link. The code lasts 10 minutes, and the request to connect ends after 24 hours.

1. Open the link the agent gave you. It opens **Give this agent your team?** You must be logged in to see it.
2. Check the page. It says which host the agent signed in through, when it asked, and the team it will act on. Under **What it will be able to do** it lists the same permissions as the approval page.
3. Type the six digits into **The code the agent showed you**, then select **Give it my team**.
4. When it works, the page says **The agent has your team**, and the agent connects in a moment.

> **Warning:** Only type a code from an agent you started yourself. The page shows whose account you are signed in as.

The code only works for the email address the agent named when it registered. An agent that registers with a named address is claimed only by that person.

If you are on a team already, the claim asks you to open Cactus and join it first, then type the code again. On the waitlist, the claim still goes through and the page shows a referral field.

An agent may ask for a new code up to 10 times. A code takes 5 wrong tries before the link closes.

## Remove an agent's access

Connected AI clients are listed and removed on [AI clients](https://cactus.heycactus.ai/766ch7-ai-clients). The approval page says the same: you can take a client back any time under AI clients.

Only the person who claimed an agent can end its connection.

## If a connection fails

| What you see | What it means | What to do |
| --- | --- | --- |
| **This approval link is incomplete. Start again from your agent.** | The page opened without the whole request. | Start the connection again from your AI client. |
| **Couldn’t verify this approval link. Start again from your agent.** | The link could not be checked. | Start the connection again from your AI client. |
| **This login has expired. Start it again from your AI client.** | The sign-in request is older than 10 minutes. | Start the connection again from your AI client. |
| **Join a teamspace before connecting an AI client.** | You logged in through a help site and are on no team. | Join a team first, as [Joining a team](https://cactus.heycactus.ai/55b9rk-joining-a-team) explains, then connect again. |
| **That code doesn’t work. Check it and try again.** | The referral code is not one Cactus accepts. | Check the code, or leave **Or enter referral code** empty to join the waitlist. |
| **This agent asked for somebody else** | You are signed in with an email other than the one the agent named. | Log in as the person the agent named, then open the link again. |
| **That isn’t the code** | The six digits do not match the code the agent showed. | Type the six digits again. |
| **Too many wrong codes** | Too many wrong codes closed the link. | Ask the agent to start again. |
| **This code has expired** | The 10-minute code has run out. | Ask the agent to start again. |
| **This agent already has a team** | Someone already typed its code. | If that wasn’t you, tell your team. |
| **This claim link can’t be verified** | The link is not one Cactus knows, or it no longer works. | Ask the agent to start again. |
| **Join your teamspace first** | Your team is already on Cactus, and you have not joined it. | Open Cactus to join your team, then type the code again. |
