Skip to main content
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 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:

    Claude Code

    Codex

    OpenClaw

  • Node.js 20 or later.
  • A Colosseum account. 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:
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.

Option 2: Run the commands yourself

1

Install the skill

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:
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.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.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.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.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.No browser, or working over SSH? Run this instead. It prints a link and a code you can enter in any browser:
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:
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 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. There you can turn sharing on or off for each one, or revoke its access.
Something not working? See Troubleshooting.