> ## Documentation Index
> Fetch the complete documentation index at: https://docs.colosseum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up

> Install Copilot, sign in with your Colosseum account, and ask your first question.

> [!WARNING]
>
> **Using an old access token?** Old tokens stop working at 00:00 UTC on October 28, 2026 (the evening of October 27 in the Americas), and they don't include Frontier or the new features. To upgrade:
>
> 1. Update the skill: `npx skills add ColosseumOrg/colosseum-copilot -g`. This replaces an older global copy. If you once installed the old skill inside a project, run `npx skills remove colosseum-copilot` in that project.
> 2. Sign in: `npx @colosseum-org/copilot-connect@0.2.3 login`
> 3. Remove `COLOSSEUM_COPILOT_PAT`, and any `COLOSSEUM_COPILOT_API_BASE` ending in `/api/v1`, from your shell profile or agent settings.

You need:

* An AI agent that can install skills and run commands, such as:

  > [card] [Claude Code](https://claude.com/product/claude-code)

  > [card] [Codex](https://openai.com/codex/)

  > [card] [OpenClaw](https://openclaw.ai)
* [Node.js](https://nodejs.org) 20 or later.
* A [Colosseum account](https://colosseum.com). Create one first if you don't have one.

There are two ways to set up. Both end in the same place.

## Option 1: Let your agent do it

Paste this into your agent:

```text wrap theme={null}
Set up Colosseum Copilot for this agent using https://colosseum.com/copilot/onboard.md. Install the official ColosseumOrg/colosseum-copilot skill, let me approve Colosseum sign-in, and return to my task.
```

Your agent installs the skill, then opens a Colosseum page in your browser. Check that it shows your account, choose **Approve**, and your agent picks up where it left off. You can [read the steps it follows](https://colosseum.com/copilot/onboard.md).

## Option 2: Run the commands yourself

**1. Install the skill**

> [tab] Claude Code
>
> ```sh theme={null}
> npx skills add ColosseumOrg/colosseum-copilot -g -a claude-code
> ```

> [tab] Codex
>
> ```sh theme={null}
> npx skills add ColosseumOrg/colosseum-copilot -g -a codex
> ```

> [tab] OpenClaw
>
> ```sh theme={null}
> npx skills add ColosseumOrg/colosseum-copilot -g -a openclaw
> ```

This installs Copilot for all your projects and replaces any older copy. For another agent, change the name after `-a`. After setup, Copilot keeps itself current and removes older copies.

Then start a new agent session so your agent loads the skill.

**2. Sign in**

Run Colosseum's sign-in tool where your agent runs:

```sh theme={null}
npx @colosseum-org/copilot-connect@0.2.3 login
```

It opens a Colosseum page in your browser. Check the account shown there, then choose **Approve**.

![The sign-in page: Colosseum Copilot wants to connect to your account. It shows the account, the permissions requested, an optional box to help improve Copilot, and Approve and Deny buttons.](https://mintcdn.com/colosseum/nUDC8CaDoE4OTOfT/copilot/images/illustrations/approve-desktop-light.webp?fit=max\&auto=format\&n=nUDC8CaDoE4OTOfT\&q=85\&s=e46e6c01ca2527561a1dd4e56528a0bf)

![The sign-in page: Colosseum Copilot wants to connect to your account. It shows the account, the permissions requested, an optional box to help improve Copilot, and Approve and Deny buttons.](https://mintcdn.com/colosseum/nUDC8CaDoE4OTOfT/copilot/images/illustrations/approve-phone-light.webp?fit=max\&auto=format\&n=nUDC8CaDoE4OTOfT\&q=85\&s=655eba18d530dbb0f2d70b6a1f822919)

![The sign-in page: Colosseum Copilot wants to connect to your account. It shows the account, the permissions requested, an optional box to help improve Copilot, and Approve and Deny buttons.](https://mintcdn.com/colosseum/nUDC8CaDoE4OTOfT/copilot/images/illustrations/approve-desktop-dark.webp?fit=max\&auto=format\&n=nUDC8CaDoE4OTOfT\&q=85\&s=8e5c351a0e8955efcd2a59630c74b1fe)

![The sign-in page: Colosseum Copilot wants to connect to your account. It shows the account, the permissions requested, an optional box to help improve Copilot, and Approve and Deny buttons.](https://mintcdn.com/colosseum/nUDC8CaDoE4OTOfT/copilot/images/illustrations/approve-phone-dark.webp?fit=max\&auto=format\&n=nUDC8CaDoE4OTOfT\&q=85\&s=70c4afa86fcc077e569e413dd18bfb52)

The page also has an optional **Help improve Copilot** box, which shares your questions and your agent's answers with Colosseum. It stays off unless you check it. See [what sharing means](https://docs.colosseum.com/copilot/privacy.md#optional-sharing).

No browser, or working over SSH? Run this instead. It prints a link and a code you can enter in any browser:

```sh theme={null}
npx @colosseum-org/copilot-connect@0.2.3 login --device
```

When the terminal says "Connected", go back to your agent.

**3. Ask your first question**

Mention Copilot so your agent knows to use it. For example:

```text wrap theme={null}
Use Colosseum Copilot: who has built payments for AI agents at Colosseum, and which teams got into the accelerator?
```

Before you act on something time-sensitive, like a deadline, open the links in the answer.

## Staying connected

* Your sign-in lasts 90 days, or until you go 30 days without using Copilot. After that, your agent will ask you to sign in again.
* To check your connection, run `npx @colosseum-org/copilot-connect@0.2.3 status`.
* To update Copilot, run the install command again and start a new agent session.
* Agents on the same computer can share one sign-in. On another computer or a remote machine, install the skill and sign in there.
* Every agent you've connected is listed on the [Connected agents page](https://colosseum.com/arena/copilot/connections). There you can turn sharing on or off for each one, or revoke its access.

Something not working? See [Troubleshooting](https://docs.colosseum.com/copilot/troubleshooting.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.