magicpath-ai 1.3.0-beta.9 → 1.3.0

package/README.md

@@ -1,16 +1,16 @@
 # MagicPath CLI
 
-A component platform for AI agents. Search, add, and integrate UI components from MagicPath directly into your projects — works with Claude Code, Cursor, and GitHub Copilot.
+A component platform for AI agents. Search and add UI components from MagicPath directly into your projects — works with Claude Code, Cursor, and GitHub Copilot.
 
 ## Quick Start
 
 ```bash
 npm install -g magicpath-ai@beta
 magicpath-ai login
-magicpath-ai init          # run in your project directory
+magicpath-ai setup-skills  # run in your project directory
 ```
 
-After `init`, Claude Code, Cursor, and GitHub Copilot automatically pick up MagicPath skills — just mention MagicPath in conversation and your agent knows what to do.
+After `setup-skills`, Claude Code, Cursor, and GitHub Copilot automatically pick up MagicPath skills — just mention MagicPath in conversation and your agent knows what to do.
 
 ## Commands
 
@@ -95,51 +95,49 @@ magicpath-ai view <generatedName>
 
 ### Components
 
-#### `add`
+#### `inspect`
+
+View a component's source code, dependencies, and import info without installing anything. Read-only — no files are written, no `package.json` is required.
 
-Add a MagicPath component to your project. Fetches the component files, writes them to your project, and installs any required dependencies.
+Works in any project type. For non-React projects (Swift, Python, etc.), use `inspect` to read MagicPath component source code as a reference for recreating the component in your target language.
 
 ```bash
-magicpath-ai add <generatedName>
-magicpath-ai add wispy-river-5234 --path src/components/ui
-magicpath-ai add wispy-river-5234 --inspect    # view source without installing
-magicpath-ai add wispy-river-5234 --dry-run    # preview file list only
+magicpath-ai inspect <generatedName>
+magicpath-ai inspect wispy-river-5234 -o json
 ```
 
 | Option | Description |
 |--------|-------------|
-| `-p, --path <path>` | Custom component path (default: `src/components/magicpath`) |
-| `--inspect` | Show full source code without installing |
-| `--dry-run` | Preview file list without writing |
-| `-y, --yes` | Skip confirmation prompts |
-| `--overwrite` | Overwrite existing files |
 | `-d, --debug` | Enable debug logging |
 
-#### `integrate`
+#### `add`
+
+Add a MagicPath component to your project. Fetches the component files, writes them to `src/components/magicpath/`, and installs any required npm dependencies.
 
-Integrate a MagicPath component into your project using AI. Offers two modes: integrate into a specific file, or retheme your entire project to match the component.
+> **Note:** `add` is for React/TypeScript projects only — it writes `.tsx` files and installs npm packages. For non-JS projects, use `inspect` to read the source code and translate it into your target language.
 
 ```bash
-magicpath-ai integrate <generatedName>
-magicpath-ai integrate wispy-river-5234 --target src/app/page.tsx
-magicpath-ai integrate wispy-river-5234 --dry-run
+magicpath-ai add <generatedName>
+magicpath-ai add wispy-river-5234 --path src/components/ui
+magicpath-ai add wispy-river-5234 --dry-run    # preview file list only
 ```
 
 | Option | Description |
 |--------|-------------|
-| `-t, --target <file>` | Target file to integrate into (skips interactive prompt) |
-| `--no-review` | Apply changes without review |
-| `--dry-run` | Show what would happen without writing |
+| `-p, --path <path>` | Custom component path (default: `src/components/magicpath`) |
+| `--dry-run` | Preview file list without writing |
+| `-y, --yes` | Skip confirmation prompts |
+| `--overwrite` | Overwrite existing files |
 | `-d, --debug` | Enable debug logging |
 
 ### AI Agent Setup
 
-#### `init`
+#### `setup-skills`
 
 Set up MagicPath skills for AI agents. Creates rule/skill files for Claude Code, Cursor, and GitHub Copilot in your project.
 
 ```bash
-magicpath-ai init
+magicpath-ai setup-skills
 ```
 
 #### `info`
@@ -190,13 +188,13 @@ The `-d, --debug` flag is available on `add`, `clone`, and `integrate` for verbo
 
 ## AI Agent Integration
 
-Running `magicpath-ai init` in your project creates skill files that teach AI agents how to use MagicPath:
+Running `magicpath-ai setup-skills` in your project creates skill files that teach AI agents how to use MagicPath:
 
 - **Claude Code** — `.claude/skills/magicpath/SKILL.md`
 - **Cursor** — `.cursor/rules/magicpath.mdc`
 - **GitHub Copilot** — `.github/instructions/magicpath.instructions.md`
 
-Once set up, agents automatically know how to search for components, add them to your project, and integrate them into specific files.
+Once set up, agents automatically know how to search for components and add them to your project.
 
 ## Requirements
 

package/dist/cli.js

@@ -1,22 +1,29 @@
 #!/usr/bin/env node
+import { readFileSync } from 'fs';
 import { program } from 'commander';
 import { setJsonMode } from './util/output.js';
+import { showBanner } from './util/banner.js';
 import { registerCloneCommand } from './commands/clone.js';
 import { registerAddCommand } from './commands/add.js';
-import { registerIntegrateCommand } from './commands/integrate.js';
-// import { registerRethemeCommand } from './commands/retheme.js';
 import { registerAuthCommands } from './commands/auth.js';
 import { registerWhoamiCommand } from './commands/whoami.js';
 import { registerListCommands } from './commands/list.js';
 import { registerSchemaCommand } from './commands/schema.js';
-import { registerInitCommand } from './commands/init.js';
+import { registerSetupSkillsCommand } from './commands/setup-skills.js';
 import { registerViewCommand } from './commands/view.js';
 import { registerInfoCommand } from './commands/info.js';
 import { registerSearchCommand } from './commands/search.js';
+import { registerInspectCommand } from './commands/inspect.js';
+import { registerListInstalledCommand } from './commands/list-installed.js';
+const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+if (process.argv.length <= 2) {
+    showBanner(pkg.version);
+    process.exit(0);
+}
 program
     .name('magicpath')
-    .description('CLI for MagicPath AI')
-    .version('1.3.0')
+    .description('')
+    .version(pkg.version)
     .option('-o, --output <format>', 'Output format: json')
     .hook('preAction', (thisCommand) => {
     const opts = thisCommand.optsWithGlobals();
@@ -26,15 +33,15 @@ program
 });
 registerCloneCommand(program);
 registerAddCommand(program);
-registerIntegrateCommand(program);
-// registerRethemeCommand(program);
 registerAuthCommands(program);
 registerWhoamiCommand(program);
 registerListCommands(program);
 registerSchemaCommand(program);
-registerInitCommand(program);
+registerSetupSkillsCommand(program);
 registerViewCommand(program);
 registerInfoCommand(program);
 registerSearchCommand(program);
+registerListInstalledCommand(program);
+registerInspectCommand(program);
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,kEAAkE;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,sBAAsB,CAAC;KACnC,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;KACtD,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;IACjC,MAAM,IAAI,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,mCAAmC;AACnC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAClE,CAAC;AAEF,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;IAC7B,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,EAAE,CAAC;KACf,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;KACpB,MAAM,CAAC,uBAAuB,EAAE,qBAAqB,CAAC;KACtD,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;IACjC,MAAM,IAAI,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;IAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,0BAA0B,CAAC,OAAO,CAAC,CAAC;AACpC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,4BAA4B,CAAC,OAAO,CAAC,CAAC;AACtC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAEhC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/add.d.ts

@@ -6,13 +6,11 @@ export declare const addOptionsSchema: z.ZodObject<{
     path: z.ZodOptional<z.ZodString>;
     debug: z.ZodDefault<z.ZodBoolean>;
     dryRun: z.ZodDefault<z.ZodBoolean>;
-    inspect: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     debug: boolean;
     yes: boolean;
     overwrite: boolean;
     dryRun: boolean;
-    inspect: boolean;
     path?: string | undefined;
 }, {
     debug?: boolean | undefined;
@@ -20,7 +18,6 @@ export declare const addOptionsSchema: z.ZodObject<{
     yes?: boolean | undefined;
     overwrite?: boolean | undefined;
     dryRun?: boolean | undefined;
-    inspect?: boolean | undefined;
 }>;
 export type AddOptions = z.infer<typeof addOptionsSchema>;
 export declare const addOutputSchema: z.ZodObject<{