Overview
@acromedia/gesso-cli scaffolds prototypes, adds Gesso to existing Next.js projects, gives coding agents versioned design-system information, and checks project health.
Installation and usage
Set up registry authentication, then run an installed CLI command with pnpm gesso:
pnpm add --save-dev @acromedia/gesso-cli
pnpm gesso <command>
Setup commands can also use pnpm dlx @acromedia/gesso-cli as shown in their reference pages.
New agent and setup commands
| Command | Purpose |
|---|---|
agent | Summarize the installed Gesso version, bundled documentation, rules, and next steps. |
create <dir> | Create a standalone Gesso prototype. |
init | Add Gesso and agent support to an existing Next.js project. |
rules [topic] | List or print Gesso rules. |
components | List components, optionally by category. |
component <Name> | Print one component's import, props, and usage. |
patterns | List patterns and their Storybook paths, optionally by category. |
pattern <Name> | Print one pattern's path, verified import status, props, and usage. |
layouts | List layouts and their Storybook paths, optionally by category. |
layout <Name> | Print one layout's path, verified import status, props, and usage. |
search --query <query> | Search component, pattern, and layout metadata. |
tokens | List token groups or one group's tokens. |
The changed health command reports eight project checks with actionable remediation.