Install the CLI and the agent skills

The crafty CLI creates sites from a starter, deploys builds to Crafty Hosting and generates TypeScript types. It also installs the Crafty agent skills: instructions that teach an AI agent (Claude Code, Claude.ai, Claude Desktop or another agent that reads skills) how to model content, build a frontend with the SDK and deploy it.

Install the CLI

The CLI needs Node.js 20 or later.

npm i -g @craftware/crafty-cli
crafty --version

Without a global install, run any command through npx:

npx @craftware/crafty-cli <command>

Then log into your tenant. The tenant comes from CRAFTY_API_URL in the project's .env; outside a project, pass it with --host:

crafty login                                  # inside a project with CRAFTY_API_URL
crafty login --host=https://your-tenant.crafty.do

crafty login opens the browser to approve the CLI and stores one session per tenant in ~/.crafty/credentials. To start a new site instead, npm create crafty@latest does the install, the login and the site in one step (see Starters and deploy).

The agent skills

Skill	What it teaches
`crafty-cms`	Content modeling through MCP, the JavaScript SDK, the visual editor and site migrations.
`crafty-deploy`	Starters, `crafty.json`, deploys from a laptop or CI, and custom domains.

Install them with the CLI

crafty skills list                       # the skills this CLI version ships
crafty skills install                    # every skill, into .claude/skills/ of the project
crafty skills install crafty-cms         # only the named skills
crafty skills install --global           # into ~/.claude/skills/ (every project)
crafty skills install --dir=.agents/skills   # into another agent's skills folder

Without installing the CLI: npx @craftware/crafty-cli skills install. If your installed CLI does not know crafty skills, update it with crafty update.

A skill copied into a project does not update itself. Run crafty skills install again after upgrading the CLI to replace it with the current version.

Download them for Claude.ai or Claude Desktop

Each skill is also published as a zip with its folder and SKILL.md:

To add one in Claude.ai or Claude Desktop:

Download the zip. Do not unzip it.
Open Settings → Capabilities and check that code execution is on; skills need it.
Under Skills, choose Upload skill and pick the zip.
Turn the skill on. Claude uses it when a conversation is about Crafty.

The zips are rebuilt on every docs deploy, so a download is always the latest version. Upload it again to update the copy in Claude.

Connect the MCP server too

The skills explain the workflow; the actions themselves go through the tenant's MCP server (https://your-tenant.crafty.do/mcp). Add it as a connector in Claude.ai or Claude Desktop, or in Claude Code:

claude mcp add --transport http crafty https://your-tenant.crafty.do/mcp \
  --header "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN"

Content modeling through MCP covers every client, tokens and scopes; Getting started covers the full flow.