@ktmcp-cli/adobe 1.0.0

package/AGENT.md

@@ -0,0 +1,46 @@
+# Adobe AEM CLI - AI Agent Guide
+
+This CLI provides programmatic access to the Adobe Experience Manager (AEM) API.
+
+## Quick Start for AI Agents
+
+```bash
+adobe config set --username admin --password admin
+adobe config set --base-url http://localhost:4502
+adobe assets list
+```
+
+## Available Commands
+
+### config
+- `adobe config set --username <user> --password <pass>` - Set AEM credentials
+- `adobe config set --base-url <url>` - Set AEM server URL
+- `adobe config get <key>` - Get a config value
+- `adobe config list` - List all config values
+
+### assets
+- `adobe assets list` - List DAM assets at default path
+- `adobe assets list --path <dam-path>` - List assets at specific path
+- `adobe assets get <asset-path>` - Get asset metadata
+- `adobe assets upload --dam-path <path> --file-name <name>` - Upload an asset
+
+### pages
+- `adobe pages list` - List pages at default path
+- `adobe pages list --path <content-path>` - List pages at specific path
+- `adobe pages get <page-path>` - Get page details
+- `adobe pages create --parent <path> --name <name> --title <title>` - Create a page
+
+### tags
+- `adobe tags list` - List tags in default namespace
+- `adobe tags list --namespace <path>` - List tags in specific namespace
+- `adobe tags create --namespace <path> --name <name> --title <title>` - Create tag
+- `adobe tags delete <tag-path>` - Delete a tag
+
+## Output Format
+
+All commands output formatted tables by default. Use `--json` flag for machine-readable JSON output.
+
+## Authentication
+
+This CLI uses HTTP Basic Authentication with your AEM username and password.
+Default AEM author URL is http://localhost:4502.

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,94 @@
+> "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/)
+
+# Adobe AEM CLI
+
+Production-ready CLI for Adobe Experience Manager (AEM) API.
+
+## Installation
+
+```bash
+npm install -g @ktmcp-cli/adobe
+```
+
+## Configuration
+
+```bash
+adobe config set --username admin --password admin
+adobe config set --base-url http://localhost:4502
+```
+
+## Usage
+
+### Assets (DAM)
+
+```bash
+# List assets in DAM
+adobe assets list
+adobe assets list --path /content/dam/my-project --limit 50
+
+# Get asset details
+adobe assets get /content/dam/my-project/image.jpg
+
+# Upload an asset
+adobe assets upload --dam-path /content/dam/my-folder --file-name photo.jpg --mime-type image/jpeg
+```
+
+### Pages
+
+```bash
+# List pages
+adobe pages list
+adobe pages list --path /content/my-site
+
+# Get page details
+adobe pages get /content/my-site/en/home
+
+# Create a new page
+adobe pages create --parent /content/my-site/en \
+  --name about-us \
+  --title "About Us" \
+  --template /libs/wcm/foundation/templates/page
+```
+
+### Tags
+
+```bash
+# List tags
+adobe tags list
+adobe tags list --namespace /content/cq:tags/my-project
+
+# Create a tag
+adobe tags create \
+  --namespace /content/cq:tags/my-project \
+  --name featured \
+  --title "Featured" \
+  --description "Featured content tag"
+
+# Delete a tag
+adobe tags delete /content/cq:tags/my-project/featured
+```
+
+### Configuration
+
+```bash
+adobe config set --username admin --password admin
+adobe config set --base-url http://localhost:4502
+adobe config get username
+adobe config list
+```
+
+## JSON Output
+
+All commands support `--json` flag for machine-readable output:
+
+```bash
+adobe assets list --json
+adobe pages list --json
+```
+
+## License
+
+MIT

package/bin/adobe.js

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@ktmcp-cli/adobe",
+  "version": "1.0.0",
+  "description": "Production-ready CLI for Adobe Experience Manager (AEM) API - Kill The MCP",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "adobe": "bin/adobe.js"
+  },
+  "keywords": ["adobe", "aem", "cli", "api", "ktmcp", "experience-manager", "cms"],
+  "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/adobe.git"
+  },
+  "homepage": "https://killthemcp.com/adobe-cli",
+  "bugs": { "url": "https://github.com/ktmcp-cli/adobe/issues" }
+}

package/src/api.js

@@ -0,0 +1,216 @@
+import axios from 'axios';
+import { getConfig } from './config.js';
+
+const DEFAULT_BASE_URL = 'http://localhost:4502';
+
+function getClient() {
+  const username = getConfig('username');
+  const password = getConfig('password');
+  const baseURL = getConfig('baseUrl') || DEFAULT_BASE_URL;
+
+  if (!username || !password) {
+    throw new Error('AEM credentials not configured. Run: adobe config set --username admin --password admin');
+  }
+
+  return axios.create({
+    baseURL,
+    auth: { username, password },
+    headers: {
+      'Accept': 'application/json',
+      'Content-Type': '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. Check your AEM credentials.');
+    if (status === 403) throw new Error('Access forbidden. Check your AEM user permissions.');
+    if (status === 404) throw new Error('Resource not found in AEM.');
+    if (status === 500) throw new Error('AEM server error. Check your AEM instance.');
+    const message = data?.error?.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 AEM at ${baseURL}. Is your AEM instance running?`);
+  } else {
+    throw error;
+  }
+}
+
+// ============================================================
+// ASSETS (DAM)
+// ============================================================
+
+export async function listAssets(path = '/content/dam', { limit = 20 } = {}) {
+  try {
+    const client = getClient();
+    const response = await client.get(`${path}.infinity.json`);
+    const data = response.data;
+    const assets = [];
+    for (const [key, value] of Object.entries(data)) {
+      if (key.startsWith('jcr:') || key === 'rep:policy') continue;
+      if (typeof value === 'object' && value['jcr:primaryType']) {
+        assets.push({
+          name: key,
+          path: `${path}/${key}`,
+          type: value['jcr:primaryType'],
+          title: value['jcr:content']?.['jcr:title'] || key,
+          mimeType: value['jcr:content']?.['jcr:mimeType'] || 'N/A',
+          lastModified: value['jcr:content']?.['jcr:lastModified'] || 'N/A'
+        });
+        if (assets.length >= limit) break;
+      }
+    }
+    return assets;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function getAsset(assetPath) {
+  try {
+    const client = getClient();
+    const response = await client.get(`${assetPath}.infinity.json`);
+    return { path: assetPath, ...response.data };
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function uploadAsset(damPath, fileName, fileContent, mimeType = 'application/octet-stream') {
+  try {
+    const client = getClient();
+    const FormData = (await import('form-data')).default;
+    const form = new FormData();
+    form.append('file', Buffer.from(fileContent), { filename: fileName, contentType: mimeType });
+    form.append('fileName', fileName);
+
+    const response = await client.post(`${damPath}.createasset.html`, form, {
+      headers: { ...form.getHeaders(), 'Accept': 'application/json' }
+    });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+// ============================================================
+// PAGES
+// ============================================================
+
+export async function listPages(path = '/content', { limit = 20 } = {}) {
+  try {
+    const client = getClient();
+    const response = await client.get(`${path}.1.json`);
+    const data = response.data;
+    const pages = [];
+    for (const [key, value] of Object.entries(data)) {
+      if (key.startsWith('jcr:') || key === 'rep:policy') continue;
+      if (typeof value === 'object') {
+        pages.push({
+          name: key,
+          path: `${path}/${key}`,
+          title: value['jcr:content']?.['jcr:title'] || key,
+          template: value['jcr:content']?.['cq:template'] || 'N/A',
+          lastModified: value['jcr:content']?.['cq:lastModified'] || 'N/A'
+        });
+        if (pages.length >= limit) break;
+      }
+    }
+    return pages;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function getPage(pagePath) {
+  try {
+    const client = getClient();
+    const response = await client.get(`${pagePath}.infinity.json`);
+    return { path: pagePath, ...response.data };
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function createPage(parentPath, pageName, title, template) {
+  try {
+    const client = getClient();
+    const params = new URLSearchParams({
+      '_charset_': 'utf-8',
+      ':name': pageName,
+      'jcr:primaryType': 'cq:Page',
+      'jcr:content/jcr:primaryType': 'cq:PageContent',
+      'jcr:content/jcr:title': title,
+      'jcr:content/cq:template': template || '/libs/wcm/foundation/templates/page'
+    });
+
+    const response = await client.post(`${parentPath}`, params, {
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
+    });
+    return { path: `${parentPath}/${pageName}`, title, template };
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+// ============================================================
+// TAGS
+// ============================================================
+
+export async function listTags(namespace = '/content/cq:tags') {
+  try {
+    const client = getClient();
+    const response = await client.get(`${namespace}.1.json`);
+    const data = response.data;
+    const tags = [];
+    for (const [key, value] of Object.entries(data)) {
+      if (key.startsWith('jcr:') || key === 'rep:policy') continue;
+      if (typeof value === 'object') {
+        tags.push({
+          name: key,
+          path: `${namespace}/${key}`,
+          title: value['jcr:title'] || key,
+          description: value['jcr:description'] || 'N/A',
+          count: value['cq:count'] || 0
+        });
+      }
+    }
+    return tags;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function createTag(namespace, tagName, title, description) {
+  try {
+    const client = getClient();
+    const params = new URLSearchParams({
+      '_charset_': 'utf-8',
+      'jcr:primaryType': 'cq:Tag',
+      'jcr:title': title,
+      ...(description && { 'jcr:description': description })
+    });
+
+    await client.post(`${namespace}/${tagName}`, params, {
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
+    });
+    return { path: `${namespace}/${tagName}`, name: tagName, title, description };
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function deleteTag(tagPath) {
+  try {
+    const client = getClient();
+    await client.delete(tagPath, {
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
+    });
+  } catch (error) {
+    handleApiError(error);
+  }
+}

package/src/config.js

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

package/src/index.js

@@ -0,0 +1,359 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { getConfig, setConfig, isConfigured, getAllConfig } from './config.js';
+import {
+  listAssets, getAsset, uploadAsset,
+  listPages, getPage, createPage,
+  listTags, createTag, deleteTag
+} 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], 50);
+  });
+  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('AEM credentials not configured.');
+    console.log('\nRun the following to configure:');
+    console.log(chalk.cyan('  adobe config set --username admin --password admin'));
+    console.log(chalk.cyan('  adobe config set --base-url http://localhost:4502'));
+    process.exit(1);
+  }
+}
+
+// ============================================================
+// Program metadata
+// ============================================================
+
+program
+  .name('adobe')
+  .description(chalk.bold('Adobe AEM CLI') + ' - Experience Manager 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('--username <user>', 'AEM username')
+  .option('--password <pass>', 'AEM password')
+  .option('--base-url <url>', 'AEM base URL (default: http://localhost:4502)')
+  .action((options) => {
+    if (options.username) { setConfig('username', options.username); printSuccess('Username set'); }
+    if (options.password) { setConfig('password', options.password); printSuccess('Password set'); }
+    if (options.baseUrl) { setConfig('baseUrl', options.baseUrl); printSuccess(`Base URL set to: ${options.baseUrl}`); }
+    if (!options.username && !options.password && !options.baseUrl) {
+      printError('No options provided. Use --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 {
+      console.log(key === 'password' ? '****' : value);
+    }
+  });
+
+configCmd
+  .command('list')
+  .description('List all configuration values')
+  .action(() => {
+    const all = getAllConfig();
+    console.log(chalk.bold('\nAdobe AEM CLI Configuration\n'));
+    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: http://localhost:4502'));
+    console.log('');
+  });
+
+// ============================================================
+// ASSETS
+// ============================================================
+
+const assetsCmd = program.command('assets').description('Manage DAM assets');
+
+assetsCmd
+  .command('list')
+  .description('List assets in DAM')
+  .option('--path <path>', 'DAM path to list', '/content/dam')
+  .option('--limit <n>', 'Maximum number of results', '20')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const assets = await withSpinner('Fetching assets...', () =>
+        listAssets(options.path, { limit: parseInt(options.limit) })
+      );
+      if (options.json) { printJson(assets); return; }
+      printTable(assets, [
+        { key: 'name', label: 'Name' },
+        { key: 'title', label: 'Title' },
+        { key: 'type', label: 'Type' },
+        { key: 'mimeType', label: 'MIME Type' },
+        { key: 'path', label: 'Path' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+assetsCmd
+  .command('get <asset-path>')
+  .description('Get details of a specific asset')
+  .option('--json', 'Output as JSON')
+  .action(async (assetPath, options) => {
+    requireAuth();
+    try {
+      const asset = await withSpinner('Fetching asset...', () => getAsset(assetPath));
+      if (options.json) { printJson(asset); return; }
+      console.log(chalk.bold('\nAsset Details\n'));
+      console.log('Path:     ', chalk.cyan(assetPath));
+      const content = asset['jcr:content'];
+      console.log('Title:    ', content?.['jcr:title'] || 'N/A');
+      console.log('MIME Type:', content?.['jcr:mimeType'] || 'N/A');
+      console.log('Type:     ', asset['jcr:primaryType'] || 'N/A');
+      console.log('Modified: ', content?.['jcr:lastModified'] || 'N/A');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+assetsCmd
+  .command('upload')
+  .description('Upload an asset to DAM')
+  .requiredOption('--dam-path <path>', 'Target DAM folder path (e.g. /content/dam/my-folder)')
+  .requiredOption('--file-name <name>', 'File name for the asset')
+  .option('--mime-type <type>', 'MIME type of the file', 'application/octet-stream')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner('Uploading asset...', () =>
+        uploadAsset(options.damPath, options.fileName, `placeholder-content-${Date.now()}`, options.mimeType)
+      );
+      if (options.json) { printJson(result); return; }
+      printSuccess(`Asset uploaded: ${chalk.bold(options.fileName)} to ${options.damPath}`);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// PAGES
+// ============================================================
+
+const pagesCmd = program.command('pages').description('Manage AEM pages');
+
+pagesCmd
+  .command('list')
+  .description('List pages under a path')
+  .option('--path <path>', 'Content path to list', '/content')
+  .option('--limit <n>', 'Maximum number of results', '20')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const pages = await withSpinner('Fetching pages...', () =>
+        listPages(options.path, { limit: parseInt(options.limit) })
+      );
+      if (options.json) { printJson(pages); return; }
+      printTable(pages, [
+        { key: 'name', label: 'Name' },
+        { key: 'title', label: 'Title' },
+        { key: 'template', label: 'Template' },
+        { key: 'path', label: 'Path' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+pagesCmd
+  .command('get <page-path>')
+  .description('Get details of a specific page')
+  .option('--json', 'Output as JSON')
+  .action(async (pagePath, options) => {
+    requireAuth();
+    try {
+      const page = await withSpinner('Fetching page...', () => getPage(pagePath));
+      if (options.json) { printJson(page); return; }
+      console.log(chalk.bold('\nPage Details\n'));
+      console.log('Path:     ', chalk.cyan(pagePath));
+      const content = page['jcr:content'];
+      console.log('Title:    ', content?.['jcr:title'] || 'N/A');
+      console.log('Template: ', content?.['cq:template'] || 'N/A');
+      console.log('Modified: ', content?.['cq:lastModified'] || 'N/A');
+      console.log('Type:     ', page['jcr:primaryType'] || 'N/A');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+pagesCmd
+  .command('create')
+  .description('Create a new AEM page')
+  .requiredOption('--parent <path>', 'Parent page path (e.g. /content/my-site)')
+  .requiredOption('--name <name>', 'Page node name (URL-friendly)')
+  .requiredOption('--title <title>', 'Page title')
+  .option('--template <template>', 'Page template path', '/libs/wcm/foundation/templates/page')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const page = await withSpinner('Creating page...', () =>
+        createPage(options.parent, options.name, options.title, options.template)
+      );
+      if (options.json) { printJson(page); return; }
+      printSuccess(`Page created: ${chalk.bold(options.title)}`);
+      console.log('Path:     ', `${options.parent}/${options.name}`);
+      console.log('Template: ', options.template);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// TAGS
+// ============================================================
+
+const tagsCmd = program.command('tags').description('Manage AEM tags');
+
+tagsCmd
+  .command('list')
+  .description('List tags in a namespace')
+  .option('--namespace <path>', 'Tag namespace path', '/content/cq:tags')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const tags = await withSpinner('Fetching tags...', () => listTags(options.namespace));
+      if (options.json) { printJson(tags); return; }
+      printTable(tags, [
+        { key: 'name', label: 'Name' },
+        { key: 'title', label: 'Title' },
+        { key: 'count', label: 'Usage Count' },
+        { key: 'path', label: 'Path' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+tagsCmd
+  .command('create')
+  .description('Create a new tag')
+  .requiredOption('--namespace <path>', 'Tag namespace path (e.g. /content/cq:tags/my-namespace)')
+  .requiredOption('--name <name>', 'Tag node name')
+  .requiredOption('--title <title>', 'Tag display title')
+  .option('--description <desc>', 'Tag description')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const tag = await withSpinner('Creating tag...', () =>
+        createTag(options.namespace, options.name, options.title, options.description)
+      );
+      if (options.json) { printJson(tag); return; }
+      printSuccess(`Tag created: ${chalk.bold(options.title)}`);
+      console.log('Path: ', tag.path);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+tagsCmd
+  .command('delete <tag-path>')
+  .description('Delete a tag by its full path')
+  .action(async (tagPath) => {
+    requireAuth();
+    try {
+      await withSpinner('Deleting tag...', () => deleteTag(tagPath));
+      printSuccess('Tag deleted successfully');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// Parse
+// ============================================================
+
+program.parse(process.argv);
+
+if (process.argv.length <= 2) {
+  program.help();
+}