heycactus.ai

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.

On this page

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.

  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.

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.

What Allow does

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.

What Allow does

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}

What Allow does

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.

What Allow does

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.

What Allow does

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

What it lets the agent do

Create products, connect GitHub and choose which repositories Cactus reads.

read your pages

What it lets the agent do

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

What it lets the agent do

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.

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. 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.

What it means

The page opened without the whole request.

What to do

Start the connection again from your AI client.

Couldn’t verify this approval link. Start again from your agent.

What it means

The link could not be checked.

What to do

Start the connection again from your AI client.

This login has expired. Start it again from your AI client.

What it means

The sign-in request is older than 10 minutes.

What to do

Start the connection again from your AI client.

Join a teamspace before connecting an AI client.

What it means

You logged in through a help site and are on no team.

What to do

Join a team first, as Joining a team explains, then connect again.

That code doesn’t work. Check it and try again.

What it means

The referral code is not one Cactus accepts.

What to do

Check the code, or leave Or enter referral code empty to join the waitlist.

This agent asked for somebody else

What it means

You are signed in with an email other than the one the agent named.

What to do

Log in as the person the agent named, then open the link again.

That isn’t the code

What it means

The six digits do not match the code the agent showed.

What to do

Type the six digits again.

Too many wrong codes

What it means

Too many wrong codes closed the link.

What to do

Ask the agent to start again.

This code has expired

What it means

The 10-minute code has run out.

What to do

Ask the agent to start again.

This agent already has a team

What it means

Someone already typed its code.

What to do

If that wasn’t you, tell your team.

This claim link can’t be verified

What it means

The link is not one Cactus knows, or it no longer works.

What to do

Ask the agent to start again.

Join your teamspace first

What it means

Your team is already on Cactus, and you have not joined it.

What to do

Open Cactus to join your team, then type the code again.

Sources

Related pages