Installation

Install the Asterism CLI and configure your environment for working with AI agent skills.

Requirements

Node.js 18 or later
npm, yarn, or pnpm package manager
A GitHub or Google account for authentication

Install the CLI

Install the Asterism CLI globally using your preferred package manager:

npm

npm install -g @asterlabs/cli

yarn

yarn global add @asterlabs/cli

pnpm

pnpm add -g @asterlabs/cli

Verify the installation by running:

aster --version

Authentication

aster login

This opens a browser window for authentication. You can sign in with GitHub or Google. After authentication, the CLI stores your credentials securely.

Using API Keys

For CI/CD or automated environments, store an API key instead of using interactive login:

aster config set token aster_live_xxx

Generate API keys from your dashboard.

Configuration

The CLI stores configuration in ~/.aster. You can customize settings with:

aster config set <key> <value>

Available Settings

Key	Description	Default
registry	Registry URL	https://www.joinasterism.com/api/v1
token	API token (set by `aster login`)	-

Skills themselves are installed into each agent's own skills directory — for Claude Code that is ./.claude/skills/ in your project, or ~/.claude/skills/ with --global. Run aster install --list-agents to see every supported agent.

MCP Server Setup (Optional)

To use skills directly with Claude Code, Cursor, or other MCP-compatible tools, configure the MCP server:

// .mcp.json (project root)
{
  "mcpServers": {
    "aster": {
      "command": "npx",
      "args": ["-y", "@asterlabs/mcp"],
      "env": {
        "ASTER_API_KEY": "aster_live_xxx"
      }
    }
  }
}

See the MCP Integration guide for detailed setup instructions.

Troubleshooting

Command not found

Make sure your global npm/yarn/pnpm bin directory is in your PATH. Run npm bin -g to find the location.

Permission denied

On macOS/Linux, you may need to fix npm permissions. See the npm documentation for solutions.

Login fails

Make sure you have a browser available. For headless environments, use an API key instead.