@ktmcp-cli/airbyte 1.0.0

package/AGENT.md

@@ -0,0 +1,48 @@
+# Airbyte CLI - AI Agent Guide
+
+This CLI provides programmatic access to the Airbyte Data Integration API.
+
+## Quick Start for AI Agents
+
+```bash
+airbyte config set --api-key YOUR_API_KEY
+airbyte config set --workspace-id YOUR_WORKSPACE_ID
+airbyte connections list
+```
+
+## Available Commands
+
+### config
+- `airbyte config set --api-key <key>` - Set API key
+- `airbyte config set --base-url <url>` - Set API base URL
+- `airbyte config set --workspace-id <id>` - Set default workspace ID
+- `airbyte config get <key>` - Get a config value
+- `airbyte config list` - List all config values
+
+### connections
+- `airbyte connections list` - List all connections
+- `airbyte connections list --workspace-id <id>` - List connections in workspace
+- `airbyte connections get <connection-id>` - Get connection details
+- `airbyte connections create --source-id <id> --destination-id <id>` - Create connection
+
+### sources
+- `airbyte sources list` - List all sources
+- `airbyte sources get <source-id>` - Get source details
+- `airbyte sources create --workspace-id <id> --name <name> --definition-id <id>` - Create source
+
+### destinations
+- `airbyte destinations list` - List all destinations
+- `airbyte destinations get <destination-id>` - Get destination details
+- `airbyte destinations create --workspace-id <id> --name <name> --definition-id <id>` - Create destination
+
+### workspaces
+- `airbyte workspaces list` - List all workspaces
+
+## Output Format
+
+All commands output formatted tables by default. Use `--json` flag for machine-readable JSON output.
+
+## Authentication
+
+This CLI supports Airbyte API key authentication. Configure your API key with `airbyte config set --api-key`.
+Default API base URL is http://localhost:8006/api for self-hosted Airbyte instances.

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,105 @@
+> "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/)
+
+# Airbyte CLI
+
+Production-ready CLI for Airbyte Data Integration API.
+
+## Installation
+
+```bash
+npm install -g @ktmcp-cli/airbyte
+```
+
+## Configuration
+
+```bash
+airbyte config set --api-key YOUR_API_KEY
+airbyte config set --base-url http://localhost:8006/api
+airbyte config set --workspace-id YOUR_WORKSPACE_ID
+```
+
+## Usage
+
+### Connections
+
+```bash
+# List all connections
+airbyte connections list
+airbyte connections list --workspace-id <id>
+
+# Get connection details
+airbyte connections get <connection-id>
+
+# Create a new connection
+airbyte connections create \
+  --source-id <source-id> \
+  --destination-id <destination-id> \
+  --name "My Pipeline" \
+  --schedule manual
+```
+
+### Sources
+
+```bash
+# List all sources
+airbyte sources list
+airbyte sources list --workspace-id <id>
+
+# Get source details
+airbyte sources get <source-id>
+
+# Create a new source
+airbyte sources create \
+  --workspace-id <id> \
+  --name "My PostgreSQL Source" \
+  --definition-id decd338e-5647-4c0b-adf4-da0e75f5a750 \
+  --config '{"host":"localhost","port":5432,"database":"mydb","username":"user","password":"pass"}'
+```
+
+### Destinations
+
+```bash
+# List all destinations
+airbyte destinations list
+
+# Get destination details
+airbyte destinations get <destination-id>
+
+# Create a new destination
+airbyte destinations create \
+  --workspace-id <id> \
+  --name "My BigQuery Destination" \
+  --definition-id 22f6c74f-5699-40ff-833c-4a879ea40133 \
+  --config '{"project_id":"my-project","dataset_id":"my_dataset"}'
+```
+
+### Workspaces
+
+```bash
+# List all workspaces
+airbyte workspaces list
+```
+
+### Configuration
+
+```bash
+airbyte config set --api-key YOUR_KEY
+airbyte config get apiKey
+airbyte config list
+```
+
+## JSON Output
+
+All commands support `--json` flag for machine-readable output:
+
+```bash
+airbyte connections list --json
+airbyte sources get <id> --json
+```
+
+## License
+
+MIT

package/bin/airbyte.js

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@ktmcp-cli/airbyte",
+  "version": "1.0.0",
+  "description": "Production-ready CLI for Airbyte Data Integration API - Kill The MCP",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "airbyte": "bin/airbyte.js"
+  },
+  "keywords": ["airbyte", "cli", "api", "ktmcp", "data-integration", "etl", "elt"],
+  "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/airbyte.git"
+  },
+  "homepage": "https://killthemcp.com/airbyte-cli",
+  "bugs": { "url": "https://github.com/ktmcp-cli/airbyte/issues" }
+}

package/src/api.js

@@ -0,0 +1,181 @@
+import axios from 'axios';
+import { getConfig } from './config.js';
+
+const DEFAULT_BASE_URL = 'http://localhost:8006/api';
+
+function getClient() {
+  const apiKey = getConfig('apiKey');
+  const token = getConfig('token');
+  const baseURL = getConfig('baseUrl') || DEFAULT_BASE_URL;
+
+  const headers = {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json'
+  };
+
+  if (apiKey) {
+    headers['Authorization'] = `Bearer ${apiKey}`;
+  } else if (token) {
+    headers['Authorization'] = `Basic ${token}`;
+  } else {
+    throw new Error('API credentials not configured. Run: airbyte config set --api-key YOUR_API_KEY');
+  }
+
+  return axios.create({ baseURL, headers });
+}
+
+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 Airbyte API key.');
+    if (status === 403) throw new Error('Access forbidden. Check your API permissions.');
+    if (status === 404) throw new Error('Resource not found.');
+    if (status === 422) throw new Error(`Validation error: ${JSON.stringify(data?.detail || data)}`);
+    if (status === 429) throw new Error('Rate limit exceeded. Please wait before retrying.');
+    const message = data?.message || data?.detail || 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 Airbyte at ${baseURL}. Is your Airbyte instance running?`);
+  } else {
+    throw error;
+  }
+}
+
+// ============================================================
+// CONNECTIONS
+// ============================================================
+
+export async function listConnections(workspaceId) {
+  try {
+    const client = getClient();
+    const body = workspaceId ? { workspaceId } : {};
+    const response = await client.post('/v1/connections/list', body);
+    return response.data.connections || [];
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function getConnection(connectionId) {
+  try {
+    const client = getClient();
+    const response = await client.post('/v1/connections/get', { connectionId });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function createConnection({ sourceId, destinationId, name, syncCatalog, scheduleType = 'manual' }) {
+  try {
+    const client = getClient();
+    const body = {
+      sourceId,
+      destinationId,
+      name: name || `Connection from ${sourceId} to ${destinationId}`,
+      status: 'active',
+      scheduleType,
+      ...(syncCatalog && { syncCatalog })
+    };
+    const response = await client.post('/v1/connections/create', body);
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+// ============================================================
+// SOURCES
+// ============================================================
+
+export async function listSources(workspaceId) {
+  try {
+    const client = getClient();
+    const body = workspaceId ? { workspaceId } : {};
+    const response = await client.post('/v1/sources/list', body);
+    return response.data.sources || [];
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function getSource(sourceId) {
+  try {
+    const client = getClient();
+    const response = await client.post('/v1/sources/get', { sourceId });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function createSource({ workspaceId, name, sourceDefinitionId, connectionConfiguration }) {
+  try {
+    const client = getClient();
+    const response = await client.post('/v1/sources/create', {
+      workspaceId,
+      name,
+      sourceDefinitionId,
+      connectionConfiguration: connectionConfiguration || {}
+    });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+// ============================================================
+// DESTINATIONS
+// ============================================================
+
+export async function listDestinations(workspaceId) {
+  try {
+    const client = getClient();
+    const body = workspaceId ? { workspaceId } : {};
+    const response = await client.post('/v1/destinations/list', body);
+    return response.data.destinations || [];
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function getDestination(destinationId) {
+  try {
+    const client = getClient();
+    const response = await client.post('/v1/destinations/get', { destinationId });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+export async function createDestination({ workspaceId, name, destinationDefinitionId, connectionConfiguration }) {
+  try {
+    const client = getClient();
+    const response = await client.post('/v1/destinations/create', {
+      workspaceId,
+      name,
+      destinationDefinitionId,
+      connectionConfiguration: connectionConfiguration || {}
+    });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+// ============================================================
+// WORKSPACES
+// ============================================================
+
+export async function listWorkspaces() {
+  try {
+    const client = getClient();
+    const response = await client.post('/v1/workspaces/list', {});
+    return response.data.workspaces || [];
+  } catch (error) {
+    handleApiError(error);
+  }
+}

package/src/config.js

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

package/src/index.js

@@ -0,0 +1,421 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { getConfig, setConfig, isConfigured, getAllConfig } from './config.js';
+import {
+  listConnections, getConnection, createConnection,
+  listSources, getSource, createSource,
+  listDestinations, getDestination, createDestination,
+  listWorkspaces
+} 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('Airbyte credentials not configured.');
+    console.log('\nRun the following to configure:');
+    console.log(chalk.cyan('  airbyte config set --api-key YOUR_API_KEY'));
+    console.log(chalk.cyan('  airbyte config set --base-url http://localhost:8006/api'));
+    process.exit(1);
+  }
+}
+
+// ============================================================
+// Program metadata
+// ============================================================
+
+program
+  .name('airbyte')
+  .description(chalk.bold('Airbyte CLI') + ' - Data integration pipelines 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('--api-key <key>', 'Airbyte API key')
+  .option('--base-url <url>', 'Airbyte API base URL (default: http://localhost:8006/api)')
+  .option('--workspace-id <id>', 'Default workspace ID')
+  .action((options) => {
+    if (options.apiKey) { setConfig('apiKey', options.apiKey); printSuccess('API key set'); }
+    if (options.baseUrl) { setConfig('baseUrl', options.baseUrl); printSuccess(`Base URL set to: ${options.baseUrl}`); }
+    if (options.workspaceId) { setConfig('workspaceId', options.workspaceId); printSuccess(`Default workspace ID set: ${options.workspaceId}`); }
+    if (!options.apiKey && !options.baseUrl && !options.workspaceId) {
+      printError('No options provided. Use --api-key, --base-url, or --workspace-id');
+    }
+  });
+
+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(value);
+    }
+  });
+
+configCmd
+  .command('list')
+  .description('List all configuration values')
+  .action(() => {
+    const all = getAllConfig();
+    console.log(chalk.bold('\nAirbyte CLI Configuration\n'));
+    console.log('API Key:      ', all.apiKey ? chalk.green('*'.repeat(16) + all.apiKey.slice(-4)) : chalk.red('not set'));
+    console.log('Base URL:     ', all.baseUrl ? chalk.green(all.baseUrl) : chalk.yellow('using default: http://localhost:8006/api'));
+    console.log('Workspace ID: ', all.workspaceId ? chalk.green(all.workspaceId) : chalk.yellow('not set (use --workspace-id with commands)'));
+    console.log('');
+  });
+
+// ============================================================
+// CONNECTIONS
+// ============================================================
+
+const connectionsCmd = program.command('connections').description('Manage data sync connections');
+
+connectionsCmd
+  .command('list')
+  .description('List all connections')
+  .option('--workspace-id <id>', 'Workspace ID (uses default if configured)')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    const workspaceId = options.workspaceId || getConfig('workspaceId');
+    try {
+      const connections = await withSpinner('Fetching connections...', () => listConnections(workspaceId));
+      if (options.json) { printJson(connections); return; }
+      printTable(connections, [
+        { key: 'connectionId', label: 'ID', format: (v) => v?.substring(0, 16) + '...' },
+        { key: 'name', label: 'Name' },
+        { key: 'status', label: 'Status' },
+        { key: 'scheduleType', label: 'Schedule' },
+        { key: 'sourceId', label: 'Source ID', format: (v) => v?.substring(0, 12) + '...' },
+        { key: 'destinationId', label: 'Dest ID', format: (v) => v?.substring(0, 12) + '...' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+connectionsCmd
+  .command('get <connection-id>')
+  .description('Get details of a specific connection')
+  .option('--json', 'Output as JSON')
+  .action(async (connectionId, options) => {
+    requireAuth();
+    try {
+      const conn = await withSpinner('Fetching connection...', () => getConnection(connectionId));
+      if (options.json) { printJson(conn); return; }
+      console.log(chalk.bold('\nConnection Details\n'));
+      console.log('ID:          ', chalk.cyan(conn.connectionId));
+      console.log('Name:        ', chalk.bold(conn.name));
+      console.log('Status:      ', conn.status === 'active' ? chalk.green(conn.status) : chalk.yellow(conn.status));
+      console.log('Schedule:    ', conn.scheduleType || 'manual');
+      console.log('Source ID:   ', conn.sourceId);
+      console.log('Dest ID:     ', conn.destinationId);
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+connectionsCmd
+  .command('create')
+  .description('Create a new connection between source and destination')
+  .requiredOption('--source-id <id>', 'Source connector ID')
+  .requiredOption('--destination-id <id>', 'Destination connector ID')
+  .option('--name <name>', 'Connection name')
+  .option('--schedule <type>', 'Schedule type (manual|cron|basic)', 'manual')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const conn = await withSpinner('Creating connection...', () =>
+        createConnection({
+          sourceId: options.sourceId,
+          destinationId: options.destinationId,
+          name: options.name,
+          scheduleType: options.schedule
+        })
+      );
+      if (options.json) { printJson(conn); return; }
+      printSuccess(`Connection created: ${chalk.bold(conn.name || conn.connectionId)}`);
+      console.log('ID:     ', conn.connectionId);
+      console.log('Status: ', conn.status);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// SOURCES
+// ============================================================
+
+const sourcesCmd = program.command('sources').description('Manage data sources');
+
+sourcesCmd
+  .command('list')
+  .description('List all sources')
+  .option('--workspace-id <id>', 'Workspace ID')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    const workspaceId = options.workspaceId || getConfig('workspaceId');
+    try {
+      const sources = await withSpinner('Fetching sources...', () => listSources(workspaceId));
+      if (options.json) { printJson(sources); return; }
+      printTable(sources, [
+        { key: 'sourceId', label: 'ID', format: (v) => v?.substring(0, 16) + '...' },
+        { key: 'name', label: 'Name' },
+        { key: 'sourceName', label: 'Type' },
+        { key: 'workspaceId', label: 'Workspace', format: (v) => v?.substring(0, 12) + '...' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+sourcesCmd
+  .command('get <source-id>')
+  .description('Get details of a specific source')
+  .option('--json', 'Output as JSON')
+  .action(async (sourceId, options) => {
+    requireAuth();
+    try {
+      const source = await withSpinner('Fetching source...', () => getSource(sourceId));
+      if (options.json) { printJson(source); return; }
+      console.log(chalk.bold('\nSource Details\n'));
+      console.log('ID:          ', chalk.cyan(source.sourceId));
+      console.log('Name:        ', chalk.bold(source.name));
+      console.log('Type:        ', source.sourceName);
+      console.log('Workspace:   ', source.workspaceId);
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+sourcesCmd
+  .command('create')
+  .description('Create a new data source')
+  .requiredOption('--workspace-id <id>', 'Workspace ID')
+  .requiredOption('--name <name>', 'Source name')
+  .requiredOption('--definition-id <id>', 'Source definition ID')
+  .option('--config <json>', 'Connection configuration as JSON')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    let connectionConfiguration = {};
+    if (options.config) {
+      try { connectionConfiguration = JSON.parse(options.config); } catch {
+        printError('Invalid JSON for --config'); process.exit(1);
+      }
+    }
+    try {
+      const source = await withSpinner('Creating source...', () =>
+        createSource({
+          workspaceId: options.workspaceId,
+          name: options.name,
+          sourceDefinitionId: options.definitionId,
+          connectionConfiguration
+        })
+      );
+      if (options.json) { printJson(source); return; }
+      printSuccess(`Source created: ${chalk.bold(source.name)}`);
+      console.log('ID:   ', source.sourceId);
+      console.log('Type: ', source.sourceName);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// DESTINATIONS
+// ============================================================
+
+const destinationsCmd = program.command('destinations').description('Manage data destinations');
+
+destinationsCmd
+  .command('list')
+  .description('List all destinations')
+  .option('--workspace-id <id>', 'Workspace ID')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    const workspaceId = options.workspaceId || getConfig('workspaceId');
+    try {
+      const destinations = await withSpinner('Fetching destinations...', () => listDestinations(workspaceId));
+      if (options.json) { printJson(destinations); return; }
+      printTable(destinations, [
+        { key: 'destinationId', label: 'ID', format: (v) => v?.substring(0, 16) + '...' },
+        { key: 'name', label: 'Name' },
+        { key: 'destinationName', label: 'Type' },
+        { key: 'workspaceId', label: 'Workspace', format: (v) => v?.substring(0, 12) + '...' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+destinationsCmd
+  .command('get <destination-id>')
+  .description('Get details of a specific destination')
+  .option('--json', 'Output as JSON')
+  .action(async (destinationId, options) => {
+    requireAuth();
+    try {
+      const dest = await withSpinner('Fetching destination...', () => getDestination(destinationId));
+      if (options.json) { printJson(dest); return; }
+      console.log(chalk.bold('\nDestination Details\n'));
+      console.log('ID:          ', chalk.cyan(dest.destinationId));
+      console.log('Name:        ', chalk.bold(dest.name));
+      console.log('Type:        ', dest.destinationName);
+      console.log('Workspace:   ', dest.workspaceId);
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+destinationsCmd
+  .command('create')
+  .description('Create a new data destination')
+  .requiredOption('--workspace-id <id>', 'Workspace ID')
+  .requiredOption('--name <name>', 'Destination name')
+  .requiredOption('--definition-id <id>', 'Destination definition ID')
+  .option('--config <json>', 'Connection configuration as JSON')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    let connectionConfiguration = {};
+    if (options.config) {
+      try { connectionConfiguration = JSON.parse(options.config); } catch {
+        printError('Invalid JSON for --config'); process.exit(1);
+      }
+    }
+    try {
+      const dest = await withSpinner('Creating destination...', () =>
+        createDestination({
+          workspaceId: options.workspaceId,
+          name: options.name,
+          destinationDefinitionId: options.definitionId,
+          connectionConfiguration
+        })
+      );
+      if (options.json) { printJson(dest); return; }
+      printSuccess(`Destination created: ${chalk.bold(dest.name)}`);
+      console.log('ID:   ', dest.destinationId);
+      console.log('Type: ', dest.destinationName);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// WORKSPACES
+// ============================================================
+
+const workspacesCmd = program.command('workspaces').description('List Airbyte workspaces');
+
+workspacesCmd
+  .command('list')
+  .description('List all workspaces')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const workspaces = await withSpinner('Fetching workspaces...', () => listWorkspaces());
+      if (options.json) { printJson(workspaces); return; }
+      printTable(workspaces, [
+        { key: 'workspaceId', label: 'ID', format: (v) => v?.substring(0, 16) + '...' },
+        { key: 'name', label: 'Name' },
+        { key: 'email', label: 'Email' },
+        { key: 'slug', label: 'Slug' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// Parse
+// ============================================================
+
+program.parse(process.argv);
+
+if (process.argv.length <= 2) {
+  program.help();
+}