Skip to main content

Getting Started

Two install paths — pick the one that matches how you work. See What is cogs? if you're not sure which.

Claude Code skills​

Install the cogs plugin once to get all 5 skills:

/plugin marketplace add catesandrew/cogs
/plugin install cogs@cogs

Then just work normally. Skills activate automatically when your prompt matches their trigger conditions — for example, asking for a "paginated, filterable table with shareable URLs" triggers nuqs-table-url-state without you naming it. Browse the Skills Catalog to see all 5 trigger conditions.

For other install methods (GitHub CLI, npm), see the "Alternative Installation Methods" section in the repo README.

@cogs npm packages​

Install whichever packages you need from the public @cogs scope — no .npmrc auth token required, these are public packages:

pnpm add @cogs/auth-events @cogs/emails @cogs/react-query

See Usage Examples for how @cogs/fetch-client, @cogs/react-query, and @cogs/auth-events fit together in a real app.

Contributing to this repo​

git clone https://github.com/catesandrew/cogs.git
cd cogs
pnpm install
pnpm build
pnpm typecheck
pnpm lint
pnpm test

This builds and tests everything under packages/* via Turborepo. This documentation site (website/) is a separate, standalone pnpm project — see Architecture for why, and run pnpm install && pnpm build inside website/ directly to work on it.