@ktmcp-cli/akeneo 1.0.0

package/AGENT.md

@@ -0,0 +1,47 @@
+# Akeneo PIM CLI - AI Agent Guide
+
+This CLI provides programmatic access to the Akeneo Product Information Management (PIM) API.
+
+## Quick Start for AI Agents
+
+```bash
+akeneo config set --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET \
+  --username YOUR_USERNAME --password YOUR_PASSWORD
+akeneo config set --base-url https://your-instance.akeneo.com/api/rest/v1
+akeneo products list
+```
+
+## Available Commands
+
+### config
+- `akeneo config set --client-id <id> --client-secret <secret> --username <user> --password <pass>` - Set credentials
+- `akeneo config set --base-url <url>` - Set API base URL
+- `akeneo config get <key>` - Get a config value
+- `akeneo config list` - List all config values
+
+### products
+- `akeneo products list` - List products
+- `akeneo products list --limit <n>` - List with limit
+- `akeneo products get <identifier>` - Get product details
+- `akeneo products create --identifier <sku> --family <family>` - Create a product
+
+### categories
+- `akeneo categories list` - List categories
+- `akeneo categories get <code>` - Get category details
+- `akeneo categories create --code <code> --labels <json>` - Create a category
+
+### attributes
+- `akeneo attributes list` - List attributes
+- `akeneo attributes list --type <type>` - List by type
+- `akeneo attributes get <code>` - Get attribute details
+- `akeneo attributes create --code <code> --type <type>` - Create attribute
+
+## Output Format
+
+All commands output formatted tables by default. Use `--json` flag for machine-readable JSON output.
+
+## Authentication
+
+This CLI uses Akeneo's OAuth2 password grant flow. You need client credentials from your Akeneo PIM instance
+(Settings > API Connections) plus a valid username and password.
+Access tokens are automatically refreshed when they expire.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KTMCP
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+> "Six months ago, everyone was talking about MCPs. And I was like, screw MCPs. Every MCP would be better as a CLI."
+>
+> — [Peter Steinberger](https://twitter.com/steipete), Founder of OpenClaw
+> [Watch on YouTube (~2:39:00)](https://www.youtube.com/@lexfridman) | [Lex Fridman Podcast #491](https://lexfridman.com/peter-steinberger/)
+
+# Akeneo PIM CLI
+
+Production-ready CLI for Akeneo PIM (Product Information Management) API.
+
+## Installation
+
+```bash
+npm install -g @ktmcp-cli/akeneo
+```
+
+## Configuration
+
+```bash
+akeneo config set --client-id YOUR_CLIENT_ID \
+  --client-secret YOUR_CLIENT_SECRET \
+  --username YOUR_USERNAME \
+  --password YOUR_PASSWORD
+akeneo config set --base-url https://your-akeneo-instance.com/api/rest/v1
+```
+
+Get API credentials from your Akeneo PIM instance under Settings > API Connections.
+
+## Usage
+
+### Products
+
+```bash
+# List products
+akeneo products list
+akeneo products list --limit 50
+
+# Get product details
+akeneo products get my-product-sku
+
+# Create a product
+akeneo products create --identifier new-sku-001 \
+  --family clothing \
+  --categories "summer,t-shirts" \
+  --values '{"name":[{"locale":"en_US","scope":null,"data":"My Product"}]}'
+```
+
+### Categories
+
+```bash
+# List categories
+akeneo categories list
+akeneo categories list --limit 100
+
+# Get category details
+akeneo categories get electronics
+
+# Create a category
+akeneo categories create --code summer-collection \
+  --parent clothing \
+  --labels '{"en_US":"Summer Collection","fr_FR":"Collection Été"}'
+```
+
+### Attributes
+
+```bash
+# List attributes
+akeneo attributes list
+akeneo attributes list --type pim_catalog_text
+
+# Get attribute details
+akeneo attributes get color
+
+# Create an attribute
+akeneo attributes create \
+  --code material \
+  --type pim_catalog_text \
+  --group product_info \
+  --localizable \
+  --labels '{"en_US":"Material","fr_FR":"Matériau"}'
+```
+
+### Configuration
+
+```bash
+akeneo config set --client-id <id>
+akeneo config get username
+akeneo config list
+```
+
+## Attribute Types
+
+- `pim_catalog_text` - Single-line text
+- `pim_catalog_textarea` - Multi-line text
+- `pim_catalog_number` - Numeric value
+- `pim_catalog_boolean` - Yes/No toggle
+- `pim_catalog_simpleselect` - Single choice from options
+- `pim_catalog_multiselect` - Multiple choices
+- `pim_catalog_date` - Date picker
+- `pim_catalog_image` - Image file
+- `pim_catalog_price_collection` - Price in multiple currencies
+- `pim_catalog_metric` - Measurement with unit
+
+## JSON Output
+
+All commands support `--json` flag for machine-readable output:
+
+```bash
+akeneo products list --json
+akeneo attributes get color --json
+```
+
+## License
+
+MIT

package/bin/akeneo.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../src/index.js';

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@ktmcp-cli/akeneo",
+  "version": "1.0.0",
+  "description": "Production-ready CLI for Akeneo PIM (Product Information Management) API - Kill The MCP",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "akeneo": "bin/akeneo.js"
+  },
+  "keywords": ["akeneo", "pim", "cli", "api", "ktmcp", "product-management", "ecommerce"],
+  "author": "KTMCP",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "axios": "^1.6.7",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "conf": "^12.0.0"
+  },
+  "engines": { "node": ">=18.0.0" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ktmcp-cli/akeneo.git"
+  },
+  "homepage": "https://killthemcp.com/akeneo-cli",
+  "bugs": { "url": "https://github.com/ktmcp-cli/akeneo/issues" }
+}

package/src/api.js

@@ -0,0 +1,213 @@
+import axios from 'axios';
+import { getConfig, setConfig } from './config.js';
+
+const DEFAULT_BASE_URL = 'https://demo.akeneo.com/api/rest/v1';
+
+async function getAccessToken() {
+  const baseUrl = getConfig('baseUrl') || DEFAULT_BASE_URL;
+  const clientId = getConfig('clientId');
+  const clientSecret = getConfig('clientSecret');
+  const username = getConfig('username');
+  const password = getConfig('password');
+
+  // Check if we have a valid cached token
+  const cachedToken = getConfig('accessToken');
+  const tokenExpiry = getConfig('tokenExpiry');
+  if (cachedToken && tokenExpiry && Date.now() < tokenExpiry) {
+    return cachedToken;
+  }
+
+  // Get the base URL without /api/rest/v1
+  const authBaseUrl = baseUrl.replace('/api/rest/v1', '');
+
+  try {
+    const response = await axios.post(`${authBaseUrl}/api/oauth/v1/token`, {
+      grant_type: 'password',
+      client_id: clientId,
+      client_secret: clientSecret,
+      username,
+      password
+    }, {
+      headers: { 'Content-Type': 'application/json' }
+    });
+
+    const { access_token, expires_in } = response.data;
+    setConfig('accessToken', access_token);
+    setConfig('tokenExpiry', Date.now() + (expires_in * 1000) - 60000);
+    return access_token;
+  } catch (error) {
+    if (error.response) {
+      const msg = error.response.data?.message || JSON.stringify(error.response.data);
+      throw new Error(`Authentication failed: ${msg}`);
+    }
+    throw new Error(`Cannot connect to Akeneo at ${authBaseUrl}. Check your base URL.`);
+  }
+}
+
+async function getClient() {
+  const token = await getAccessToken();
+  const baseURL = getConfig('baseUrl') || DEFAULT_BASE_URL;
+
+  return axios.create({
+    baseURL,
+    headers: {
+      'Authorization': `Bearer ${token}`,
+      'Content-Type': 'application/json',
+      'Accept': 'application/json'
+    }
+  });
+}
+
+function handleApiError(error) {
+  if (error.response) {
+    const status = error.response.status;
+    const data = error.response.data;
+    if (status === 401) throw new Error('Authentication failed. Run: akeneo config set --client-id ... --client-secret ... --username ... --password ...');
+    if (status === 403) throw new Error('Access forbidden. Check your Akeneo user permissions.');
+    if (status === 404) throw new Error('Resource not found in Akeneo.');
+    if (status === 422) throw new Error(`Validation error: ${JSON.stringify(data?.errors || data)}`);
+    if (status === 429) throw new Error('Rate limit exceeded. Please wait before retrying.');
+    const message = data?.message || JSON.stringify(data);
+    throw new Error(`API Error (${status}): ${message}`);
+  } else if (error.request) {
+    const baseURL = getConfig('baseUrl') || DEFAULT_BASE_URL;
+    throw new Error(`No response from Akeneo at ${baseURL}. Check your instance URL.`);
+  } else {
+    throw error;
+  }
+}
+
+function parseAkeneoList(response) {
+  // Akeneo returns paginated results in HAL format
+  const data = response.data;
+  if (data._embedded && data._embedded.items) {
+    return data._embedded.items;
+  }
+  return Array.isArray(data) ? data : [];
+}
+
+// ============================================================
+// PRODUCTS
+// ============================================================
+
+export async function listProducts({ limit = 20, page = 1, search } = {}) {
+  try {
+    const client = await getClient();
+    const params = { limit, page };
+    if (search) params.search = search;
+    const response = await client.get('/products', { params });
+    return parseAkeneoList(response);
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function getProduct(code) {
+  try {
+    const client = await getClient();
+    const response = await client.get(`/products/${code}`);
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function createProduct({ identifier, family, categories, values }) {
+  try {
+    const client = await getClient();
+    const body = {
+      identifier,
+      ...(family && { family }),
+      ...(categories && { categories }),
+      ...(values && { values })
+    };
+    await client.post('/products', body);
+    return { identifier, family, categories };
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+// ============================================================
+// CATEGORIES
+// ============================================================
+
+export async function listCategories({ limit = 20, page = 1 } = {}) {
+  try {
+    const client = await getClient();
+    const params = { limit, page };
+    const response = await client.get('/categories', { params });
+    return parseAkeneoList(response);
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function getCategory(code) {
+  try {
+    const client = await getClient();
+    const response = await client.get(`/categories/${code}`);
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function createCategory({ code, parent, labels }) {
+  try {
+    const client = await getClient();
+    const body = {
+      code,
+      ...(parent && { parent }),
+      ...(labels && { labels })
+    };
+    await client.post('/categories', body);
+    return { code, parent, labels };
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+// ============================================================
+// ATTRIBUTES
+// ============================================================
+
+export async function listAttributes({ limit = 20, page = 1, type } = {}) {
+  try {
+    const client = await getClient();
+    const params = { limit, page };
+    if (type) params.search = JSON.stringify({ type: [{ operator: '=', value: type }] });
+    const response = await client.get('/attributes', { params });
+    return parseAkeneoList(response);
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function getAttribute(code) {
+  try {
+    const client = await getClient();
+    const response = await client.get(`/attributes/${code}`);
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function createAttribute({ code, type, group, labels, scopable = false, localizable = false }) {
+  try {
+    const client = await getClient();
+    const body = {
+      code,
+      type,
+      group: group || 'other',
+      scopable,
+      localizable,
+      ...(labels && { labels })
+    };
+    await client.post('/attributes', body);
+    return { code, type, group: group || 'other' };
+  } catch (error) {
+    handleApiError(error);
+  }
+}

package/src/config.js

@@ -0,0 +1,19 @@
+import Conf from 'conf';
+
+const config = new Conf({ projectName: '@ktmcp-cli/akeneo' });
+
+export function getConfig(key) {
+  return config.get(key);
+}
+
+export function setConfig(key, value) {
+  config.set(key, value);
+}
+
+export function isConfigured() {
+  return !!config.get('clientId') && !!config.get('clientSecret') && !!config.get('username') && !!config.get('password');
+}
+
+export function getAllConfig() {
+  return config.store;
+}

package/src/index.js

@@ -0,0 +1,430 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { getConfig, setConfig, isConfigured, getAllConfig } from './config.js';
+import {
+  listProducts, getProduct, createProduct,
+  listCategories, getCategory, createCategory,
+  listAttributes, getAttribute, createAttribute
+} from './api.js';
+
+const program = new Command();
+
+// ============================================================
+// Helpers
+// ============================================================
+
+function printSuccess(message) {
+  console.log(chalk.green('✓') + ' ' + message);
+}
+
+function printError(message) {
+  console.error(chalk.red('✗') + ' ' + message);
+}
+
+function printTable(data, columns) {
+  if (!data || data.length === 0) {
+    console.log(chalk.yellow('No results found.'));
+    return;
+  }
+  const widths = {};
+  columns.forEach(col => {
+    widths[col.key] = col.label.length;
+    data.forEach(row => {
+      const val = String(col.format ? col.format(row[col.key], row) : (row[col.key] ?? ''));
+      if (val.length > widths[col.key]) widths[col.key] = val.length;
+    });
+    widths[col.key] = Math.min(widths[col.key], 45);
+  });
+  const header = columns.map(col => col.label.padEnd(widths[col.key])).join('  ');
+  console.log(chalk.bold(chalk.cyan(header)));
+  console.log(chalk.dim('─'.repeat(header.length)));
+  data.forEach(row => {
+    const line = columns.map(col => {
+      const val = String(col.format ? col.format(row[col.key], row) : (row[col.key] ?? ''));
+      return val.substring(0, widths[col.key]).padEnd(widths[col.key]);
+    }).join('  ');
+    console.log(line);
+  });
+  console.log(chalk.dim(`\n${data.length} result(s)`));
+}
+
+function printJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function withSpinner(message, fn) {
+  const spinner = ora(message).start();
+  try {
+    const result = await fn();
+    spinner.stop();
+    return result;
+  } catch (error) {
+    spinner.stop();
+    throw error;
+  }
+}
+
+function requireAuth() {
+  if (!isConfigured()) {
+    printError('Akeneo credentials not configured.');
+    console.log('\nRun the following to configure:');
+    console.log(chalk.cyan('  akeneo config set --client-id <id> --client-secret <secret> --username <user> --password <pass>'));
+    console.log(chalk.cyan('  akeneo config set --base-url https://your-akeneo-instance.com/api/rest/v1'));
+    process.exit(1);
+  }
+}
+
+// ============================================================
+// Program metadata
+// ============================================================
+
+program
+  .name('akeneo')
+  .description(chalk.bold('Akeneo PIM CLI') + ' - Product information management from your terminal')
+  .version('1.0.0');
+
+// ============================================================
+// CONFIG
+// ============================================================
+
+const configCmd = program.command('config').description('Manage CLI configuration');
+
+configCmd
+  .command('set')
+  .description('Set configuration values')
+  .option('--client-id <id>', 'Akeneo OAuth2 client ID')
+  .option('--client-secret <secret>', 'Akeneo OAuth2 client secret')
+  .option('--username <user>', 'Akeneo username')
+  .option('--password <pass>', 'Akeneo password')
+  .option('--base-url <url>', 'Akeneo API base URL (default: https://demo.akeneo.com/api/rest/v1)')
+  .action((options) => {
+    if (options.clientId) { setConfig('clientId', options.clientId); printSuccess('Client ID set'); }
+    if (options.clientSecret) { setConfig('clientSecret', options.clientSecret); printSuccess('Client secret set'); }
+    if (options.username) { setConfig('username', options.username); printSuccess(`Username set: ${options.username}`); }
+    if (options.password) { setConfig('password', options.password); printSuccess('Password set'); }
+    if (options.baseUrl) { setConfig('baseUrl', options.baseUrl); printSuccess(`Base URL set: ${options.baseUrl}`); }
+    if (!options.clientId && !options.clientSecret && !options.username && !options.password && !options.baseUrl) {
+      printError('No options provided. Use --client-id, --client-secret, --username, --password, or --base-url');
+    }
+  });
+
+configCmd
+  .command('get <key>')
+  .description('Get a configuration value')
+  .action((key) => {
+    const value = getConfig(key);
+    if (value === undefined) {
+      printError(`Key "${key}" not found`);
+    } else {
+      const sensitive = ['clientSecret', 'password', 'accessToken'];
+      console.log(sensitive.includes(key) ? '****' : value);
+    }
+  });
+
+configCmd
+  .command('list')
+  .description('List all configuration values')
+  .action(() => {
+    const all = getAllConfig();
+    console.log(chalk.bold('\nAkeneo PIM CLI Configuration\n'));
+    console.log('Client ID:     ', all.clientId ? chalk.green(all.clientId) : chalk.red('not set'));
+    console.log('Client Secret: ', all.clientSecret ? chalk.green('****') : chalk.red('not set'));
+    console.log('Username:      ', all.username ? chalk.green(all.username) : chalk.red('not set'));
+    console.log('Password:      ', all.password ? chalk.green('****') : chalk.red('not set'));
+    console.log('Base URL:      ', all.baseUrl ? chalk.green(all.baseUrl) : chalk.yellow('using default: https://demo.akeneo.com/api/rest/v1'));
+    console.log('');
+  });
+
+// ============================================================
+// PRODUCTS
+// ============================================================
+
+const productsCmd = program.command('products').description('Manage PIM products');
+
+productsCmd
+  .command('list')
+  .description('List products')
+  .option('--limit <n>', 'Maximum number of results', '20')
+  .option('--page <n>', 'Page number', '1')
+  .option('--search <query>', 'Search filter (JSON format)')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const products = await withSpinner('Fetching products...', () =>
+        listProducts({ limit: parseInt(options.limit), page: parseInt(options.page), search: options.search })
+      );
+      if (options.json) { printJson(products); return; }
+      printTable(products, [
+        { key: 'identifier', label: 'Identifier' },
+        { key: 'family', label: 'Family' },
+        { key: 'enabled', label: 'Enabled', format: (v) => v ? chalk.green('Yes') : chalk.red('No') },
+        { key: 'categories', label: 'Categories', format: (v) => Array.isArray(v) ? v.join(', ') : v || 'N/A' },
+        { key: 'created', label: 'Created', format: (v) => v ? v.substring(0, 10) : 'N/A' },
+        { key: 'updated', label: 'Updated', format: (v) => v ? v.substring(0, 10) : 'N/A' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+productsCmd
+  .command('get <identifier>')
+  .description('Get details of a specific product')
+  .option('--json', 'Output as JSON')
+  .action(async (identifier, options) => {
+    requireAuth();
+    try {
+      const product = await withSpinner('Fetching product...', () => getProduct(identifier));
+      if (options.json) { printJson(product); return; }
+      console.log(chalk.bold('\nProduct Details\n'));
+      console.log('Identifier:  ', chalk.cyan(product.identifier));
+      console.log('Family:      ', product.family || 'N/A');
+      console.log('Enabled:     ', product.enabled ? chalk.green('Yes') : chalk.red('No'));
+      console.log('Categories:  ', Array.isArray(product.categories) ? product.categories.join(', ') : 'N/A');
+      console.log('Groups:      ', Array.isArray(product.groups) ? product.groups.join(', ') : 'N/A');
+      console.log('Created:     ', product.created || 'N/A');
+      console.log('Updated:     ', product.updated || 'N/A');
+      if (product.values && Object.keys(product.values).length > 0) {
+        console.log(chalk.bold('\nAttributes (first 10):\n'));
+        const entries = Object.entries(product.values).slice(0, 10);
+        entries.forEach(([attr, vals]) => {
+          const firstVal = vals?.[0];
+          const displayVal = firstVal?.data !== undefined ?
+            (typeof firstVal.data === 'object' ? JSON.stringify(firstVal.data) : String(firstVal.data)) : 'N/A';
+          console.log(`  ${chalk.cyan(attr.padEnd(25))} ${displayVal.substring(0, 50)}`);
+        });
+      }
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+productsCmd
+  .command('create')
+  .description('Create a new product')
+  .requiredOption('--identifier <id>', 'Product identifier (SKU)')
+  .option('--family <family>', 'Product family code')
+  .option('--categories <cats>', 'Comma-separated category codes')
+  .option('--values <json>', 'Product attribute values as JSON')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    let values;
+    if (options.values) {
+      try { values = JSON.parse(options.values); } catch {
+        printError('Invalid JSON for --values'); process.exit(1);
+      }
+    }
+    const categories = options.categories ? options.categories.split(',').map(c => c.trim()) : undefined;
+    try {
+      const product = await withSpinner('Creating product...', () =>
+        createProduct({ identifier: options.identifier, family: options.family, categories, values })
+      );
+      if (options.json) { printJson(product); return; }
+      printSuccess(`Product created: ${chalk.bold(options.identifier)}`);
+      if (options.family) console.log('Family: ', options.family);
+      if (categories) console.log('Categories: ', categories.join(', '));
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// CATEGORIES
+// ============================================================
+
+const categoriesCmd = program.command('categories').description('Manage PIM categories');
+
+categoriesCmd
+  .command('list')
+  .description('List categories')
+  .option('--limit <n>', 'Maximum number of results', '20')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const categories = await withSpinner('Fetching categories...', () =>
+        listCategories({ limit: parseInt(options.limit) })
+      );
+      if (options.json) { printJson(categories); return; }
+      printTable(categories, [
+        { key: 'code', label: 'Code' },
+        { key: 'parent', label: 'Parent', format: (v) => v || '(root)' },
+        { key: 'labels', label: 'Label (en)', format: (v) => v?.en_US || Object.values(v || {})[0] || 'N/A' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+categoriesCmd
+  .command('get <code>')
+  .description('Get details of a specific category')
+  .option('--json', 'Output as JSON')
+  .action(async (code, options) => {
+    requireAuth();
+    try {
+      const category = await withSpinner('Fetching category...', () => getCategory(code));
+      if (options.json) { printJson(category); return; }
+      console.log(chalk.bold('\nCategory Details\n'));
+      console.log('Code:   ', chalk.cyan(category.code));
+      console.log('Parent: ', category.parent || '(root)');
+      if (category.labels) {
+        console.log('Labels:');
+        Object.entries(category.labels).forEach(([locale, label]) => {
+          console.log(`  ${locale}: ${label}`);
+        });
+      }
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+categoriesCmd
+  .command('create')
+  .description('Create a new category')
+  .requiredOption('--code <code>', 'Category code')
+  .option('--parent <parent>', 'Parent category code')
+  .option('--labels <json>', 'Labels as JSON, e.g. \'{"en_US":"Electronics","fr_FR":"Électronique"}\'')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    let labels;
+    if (options.labels) {
+      try { labels = JSON.parse(options.labels); } catch {
+        printError('Invalid JSON for --labels'); process.exit(1);
+      }
+    }
+    try {
+      const category = await withSpinner('Creating category...', () =>
+        createCategory({ code: options.code, parent: options.parent, labels })
+      );
+      if (options.json) { printJson(category); return; }
+      printSuccess(`Category created: ${chalk.bold(options.code)}`);
+      if (options.parent) console.log('Parent: ', options.parent);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// ATTRIBUTES
+// ============================================================
+
+const attributesCmd = program.command('attributes').description('Manage PIM attributes');
+
+attributesCmd
+  .command('list')
+  .description('List attributes')
+  .option('--limit <n>', 'Maximum number of results', '20')
+  .option('--type <type>', 'Filter by attribute type (pim_catalog_text|pim_catalog_number|pim_catalog_boolean|etc)')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const attributes = await withSpinner('Fetching attributes...', () =>
+        listAttributes({ limit: parseInt(options.limit), type: options.type })
+      );
+      if (options.json) { printJson(attributes); return; }
+      printTable(attributes, [
+        { key: 'code', label: 'Code' },
+        { key: 'type', label: 'Type' },
+        { key: 'group', label: 'Group' },
+        { key: 'localizable', label: 'Localizable', format: (v) => v ? 'Yes' : 'No' },
+        { key: 'scopable', label: 'Scopable', format: (v) => v ? 'Yes' : 'No' },
+        { key: 'labels', label: 'Label (en)', format: (v) => v?.en_US || Object.values(v || {})[0] || 'N/A' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+attributesCmd
+  .command('get <code>')
+  .description('Get details of a specific attribute')
+  .option('--json', 'Output as JSON')
+  .action(async (code, options) => {
+    requireAuth();
+    try {
+      const attr = await withSpinner('Fetching attribute...', () => getAttribute(code));
+      if (options.json) { printJson(attr); return; }
+      console.log(chalk.bold('\nAttribute Details\n'));
+      console.log('Code:        ', chalk.cyan(attr.code));
+      console.log('Type:        ', chalk.bold(attr.type));
+      console.log('Group:       ', attr.group || 'N/A');
+      console.log('Localizable: ', attr.localizable ? chalk.green('Yes') : 'No');
+      console.log('Scopable:    ', attr.scopable ? chalk.green('Yes') : 'No');
+      console.log('Unique:      ', attr.unique ? chalk.yellow('Yes') : 'No');
+      console.log('Required:    ', attr.is_required ? chalk.yellow('Yes') : 'No');
+      if (attr.labels) {
+        console.log('Labels:');
+        Object.entries(attr.labels).forEach(([locale, label]) => {
+          console.log(`  ${locale}: ${label}`);
+        });
+      }
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+attributesCmd
+  .command('create')
+  .description('Create a new attribute')
+  .requiredOption('--code <code>', 'Attribute code')
+  .requiredOption('--type <type>', 'Attribute type (pim_catalog_text|pim_catalog_number|pim_catalog_boolean|pim_catalog_textarea|pim_catalog_simpleselect|pim_catalog_multiselect|pim_catalog_date|pim_catalog_file|pim_catalog_image|pim_catalog_price_collection|pim_catalog_metric)')
+  .option('--group <group>', 'Attribute group code', 'other')
+  .option('--localizable', 'Make attribute localizable')
+  .option('--scopable', 'Make attribute scopable')
+  .option('--labels <json>', 'Labels as JSON, e.g. \'{"en_US":"Color","fr_FR":"Couleur"}\'')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    let labels;
+    if (options.labels) {
+      try { labels = JSON.parse(options.labels); } catch {
+        printError('Invalid JSON for --labels'); process.exit(1);
+      }
+    }
+    try {
+      const attr = await withSpinner('Creating attribute...', () =>
+        createAttribute({
+          code: options.code,
+          type: options.type,
+          group: options.group,
+          localizable: !!options.localizable,
+          scopable: !!options.scopable,
+          labels
+        })
+      );
+      if (options.json) { printJson(attr); return; }
+      printSuccess(`Attribute created: ${chalk.bold(options.code)}`);
+      console.log('Type:  ', options.type);
+      console.log('Group: ', options.group);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// Parse
+// ============================================================
+
+program.parse(process.argv);
+
+if (process.argv.length <= 2) {
+  program.help();
+}