Prerequisites

Before starting, make sure you have the following installed:

Required

Tool	Version	Check
Node.js	>=24.0.0 (recommended: 24.14.1)	node --version
pnpm	>=10.0.0	pnpm --version
Git	Latest	git --version

Install pnpm

corepack enable
corepack prepare pnpm@10 --activate

Or via npm:

npm install -g pnpm

GitHub Packages token

The @cactus-agents/* packages are published to GitHub Packages, not to the public npm registry. Installing them needs two things: a registry mapping for the @cactus-agents scope, and a read token.

1. Get a token

You need a GitHub Personal Access Token with the read:packages scope. Request one from the Cactus team, or — if your GitHub account has been granted access to the packages — create your own at GitHub → Settings → Developer settings → Personal access tokens, selecting only read:packages.

2. Create your .npmrc

The repository does not ship a ready-to-use .npmrc — that file is gitignored, precisely so nobody commits a token. What ships is the template .npmrc.example. Copy it and fill in your token:

cp .npmrc.example .npmrc

The template already carries both required lines — replace the token placeholder with your own token:

@cactus-agents:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=SUA_TOKEN_AQUI

:::caution Both lines are required The @cactus-agents:registry= line is what tells pnpm to resolve the scope against GitHub Packages. With only the _authToken line, pnpm looks for @cactus-agents/* on the public npm registry and pnpm install fails with a 404 — even though your token is perfectly valid. :::

Alternative: configure it globally

If you prefer to keep credentials out of the project directory, put both lines in your global ~/.npmrc instead and skip the cp above. Do not split them across the two files thinking the project provides the registry line — it does not.

cuidado

Never commit tokens. The project's .npmrc is listed in .gitignore, so a token placed there stays local — but double-check before committing if you have custom git settings.

Recommended

• VS Code with Biome extension (biomejs.biome)
• Tailwind CSS IntelliSense extension for VS Code