How to set up Meta's Astryx design system for Claude Code

Astryx is a React design system that Meta used internally for eight years before open-sourcing it. It ships 150+ components, themes, page templates and a CLI, so a coding agent looks up component docs through the CLI too.

1. Install the package, a theme and the CLI in a React 19+ project.

npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli

1. Run init once. It writes the component index into AGENTS.md or CLAUDE.md, so the agent knows which components, templates and tokens exist.

npx @astryxdesign/cli init

1. Pull up component docs and a page template yourself.

npx @astryxdesign/cli component --list
npx @astryxdesign/cli component Button
npx @astryxdesign/cli template dashboard

It is still in beta. Always use the scoped name @astryxdesign/cli with npx. Before the CLI is installed, a bare npx astryx runs an unrelated npm package with the same name.