MagicPath

A platform for building, sharing, and installing UI components via AI. Components are added as source code to the user's project via the magicpath-ai CLI.

Terminology: Users often refer to MagicPath components as "designs" — the two terms are interchangeable. When a user says "design," "my designs," or "that design," treat it as meaning a MagicPath component. Search, inspect, and install accordingly.

Users also refer to MagicPath design systems as "themes." When a user says "theme," "my themes," or "use the X theme," they mean a MagicPath design system — a set of CSS variables, fonts, and styling instructions. Use list-themes and get-theme to work with them.

First Step

Run magicpath-ai info -o json to check auth status, project context, and CLI availability.

• If the CLI is missing, invoke it with npx magicpath-ai.
• If auth.authenticated is false, run magicpath-ai login, wait for browser auth to finish, then verify with magicpath-ai whoami -o json.

Workflow

Always use -o json for all data-returning commands (search, list-projects, list-components, list-themes, get-theme, info, add, inspect). This gives you structured output to work with instead of human-readable tables.