Prerequisites

Before starting, make sure you have the following installed:

Required

Tool	Version	Check
Node.js	>=20.14.0 (recommended: 22.18.0)	node --version
pnpm	Latest	pnpm --version
Git	Latest	git --version

Install pnpm

corepack enable
corepack prepare pnpm@latest --activate

Or via npm:

npm install -g pnpm

GitHub Packages token

You need a read-only token to install @cactus-agents/* packages from GitHub Packages.

1. You will receive a token from the Cactus team
2. Add the token to your global ~/.npmrc:

//npm.pkg.github.com/:_authToken=YOUR_TOKEN_HERE

The project already includes an .npmrc that points the @cactus-agents scope to GitHub Packages. You only need to configure the auth token.

cuidado

Never commit tokens to the repository. The project .npmrc only contains the registry URL, not the token. Your personal token should live in ~/.npmrc (global).

Recommended

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