@ktmcp-cli/awsbatch 1.0.0

package/AGENT.md

@@ -0,0 +1,96 @@
+# AGENT.md — AWS Batch CLI for AI Agents
+
+This document explains how to use the AWS Batch CLI as an AI agent.
+
+## Overview
+
+The `awsbatch` CLI provides access to the AWS Batch Computing API. Requires AWS credentials with Batch permissions.
+
+## Prerequisites
+
+```bash
+awsbatch config set accessKeyId YOUR_AWS_ACCESS_KEY_ID
+awsbatch config set secretAccessKey YOUR_AWS_SECRET_ACCESS_KEY
+awsbatch config set region us-east-1
+```
+
+## All Commands
+
+### Config
+
+```bash
+awsbatch config get <key>
+awsbatch config set <key> <value>
+awsbatch config list
+```
+
+### Jobs
+
+```bash
+# Submit
+awsbatch jobs submit --name my-job --queue my-queue --definition my-def
+awsbatch jobs submit --name my-job --queue my-queue --definition my-def --parameters '{"key":"val"}'
+awsbatch jobs submit --name my-job --queue my-queue --definition my-def --container-overrides '{"command":["cmd"]}'
+
+# Status
+awsbatch jobs get <job-id>
+
+# List
+awsbatch jobs list --queue my-queue
+awsbatch jobs list --queue my-queue --status RUNNING
+awsbatch jobs list --queue my-queue --status SUCCEEDED
+awsbatch jobs list --queue my-queue --status FAILED
+
+# Describe multiple
+awsbatch jobs describe <job-id-1> <job-id-2>
+
+# Terminate
+awsbatch jobs terminate <job-id>
+awsbatch jobs terminate <job-id> --reason "No longer needed"
+```
+
+### Queues
+
+```bash
+awsbatch queues list
+awsbatch queues get <queue-name>
+awsbatch queues create --name <name> --state ENABLED --priority 1
+awsbatch queues update <queue-name> --state DISABLED
+awsbatch queues update <queue-name> --priority 10
+```
+
+### Job Definitions
+
+```bash
+awsbatch definitions list
+awsbatch definitions list --name <name>
+awsbatch definitions list --status ACTIVE
+awsbatch definitions describe <definition-name>
+awsbatch definitions register --name <name> --type container --container '{"image":"img:tag","vcpus":1,"memory":512}'
+```
+
+## JSON Output
+
+All commands support `--json`:
+
+```bash
+awsbatch jobs get <id> --json
+awsbatch queues list --json
+awsbatch definitions list --json
+```
+
+## Job Status Values
+
+- SUBMITTED — Job submitted, awaiting scheduling
+- PENDING — Job pending scheduling
+- RUNNABLE — Job scheduled, waiting for resources
+- STARTING — Job starting
+- RUNNING — Job running
+- SUCCEEDED — Job completed successfully
+- FAILED — Job failed
+
+## Error Handling
+
+The CLI exits with code 1 on error and prints to stderr.
+- `AWS authentication failed` — Check accessKeyId and secretAccessKey
+- `Resource not found` — Check queue/definition names and job IDs

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,97 @@
+> "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/)
+
+# AWS Batch CLI
+
+Production-ready CLI for the AWS Batch Computing API. Submit and manage batch jobs, queues, and job definitions from your terminal.
+
+## Installation
+
+```bash
+npm install -g @ktmcp-cli/awsbatch
+```
+
+## Configuration
+
+```bash
+awsbatch config set accessKeyId YOUR_AWS_ACCESS_KEY_ID
+awsbatch config set secretAccessKey YOUR_AWS_SECRET_ACCESS_KEY
+awsbatch config set region us-east-1
+```
+
+## Usage
+
+### Jobs
+
+```bash
+# Submit a job
+awsbatch jobs submit --name my-job --queue my-queue --definition my-job-def
+awsbatch jobs submit --name my-job --queue my-queue --definition my-job-def \
+  --parameters '{"key":"value"}' \
+  --container-overrides '{"command":["my-script.sh"]}'
+
+# Get job status
+awsbatch jobs get <job-id>
+
+# List jobs in a queue
+awsbatch jobs list --queue my-queue
+awsbatch jobs list --queue my-queue --status RUNNING
+awsbatch jobs list --queue my-queue --status SUCCEEDED --limit 20
+
+# Describe multiple jobs
+awsbatch jobs describe <job-id-1> <job-id-2>
+
+# Terminate a job
+awsbatch jobs terminate <job-id>
+awsbatch jobs terminate <job-id> --reason "No longer needed"
+```
+
+### Queues
+
+```bash
+# List job queues
+awsbatch queues list
+
+# Get queue details
+awsbatch queues get my-queue
+
+# Create a queue
+awsbatch queues create --name my-queue --priority 10
+awsbatch queues create --name my-queue --state ENABLED --priority 5
+
+# Update a queue
+awsbatch queues update my-queue --state DISABLED
+awsbatch queues update my-queue --priority 20
+```
+
+### Job Definitions
+
+```bash
+# List job definitions
+awsbatch definitions list
+awsbatch definitions list --name my-definition
+awsbatch definitions list --status ACTIVE
+
+# Describe a job definition
+awsbatch definitions describe my-definition
+
+# Register a job definition
+awsbatch definitions register --name my-job-def --type container \
+  --container '{"image":"my-image:latest","vcpus":1,"memory":512}'
+```
+
+### JSON Output
+
+All commands support `--json`:
+
+```bash
+awsbatch jobs get <id> --json
+awsbatch queues list --json
+awsbatch definitions list --json | jq '.[].jobDefinitionName'
+```
+
+## License
+
+MIT

package/bin/awsbatch.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+import(join(__dirname, '..', 'src', 'index.js'));

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@ktmcp-cli/awsbatch",
+  "version": "1.0.0",
+  "description": "Production-ready CLI for AWS Batch Computing API - Kill The MCP",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "awsbatch": "bin/awsbatch.js"
+  },
+  "keywords": ["awsbatch", "aws", "batch", "jobs", "compute", "cli", "api", "ktmcp"],
+  "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/awsbatch.git"
+  },
+  "homepage": "https://killthemcp.com/awsbatch-cli",
+  "bugs": { "url": "https://github.com/ktmcp-cli/awsbatch/issues" }
+}

package/src/api.js

@@ -0,0 +1,230 @@
+import axios from 'axios';
+import crypto from 'crypto';
+import { getConfig } from './config.js';
+
+/**
+ * AWS Signature Version 4 signing helper
+ */
+function sign(key, msg) {
+  return crypto.createHmac('sha256', key).update(msg).digest();
+}
+
+function getSigningKey(secretKey, dateStamp, regionName, serviceName) {
+  const kDate = sign('AWS4' + secretKey, dateStamp);
+  const kRegion = sign(kDate, regionName);
+  const kService = sign(kRegion, serviceName);
+  return sign(kService, 'aws4_request');
+}
+
+function buildAuthHeader({ method, url, body, service, region, accessKeyId, secretAccessKey }) {
+  const parsedUrl = new URL(url);
+  const host = parsedUrl.host;
+  const path = parsedUrl.pathname;
+  const queryString = parsedUrl.search ? parsedUrl.search.slice(1) : '';
+
+  const now = new Date();
+  const amzDate = now.toISOString().replace(/[:-]|\.\d{3}/g, '').slice(0, 15) + 'Z';
+  const dateStamp = amzDate.slice(0, 8);
+
+  const payloadHash = crypto.createHash('sha256').update(body || '').digest('hex');
+
+  const canonicalHeaders = `host:${host}\nx-amz-date:${amzDate}\n`;
+  const signedHeaders = 'host;x-amz-date';
+
+  const canonicalRequest = [
+    method.toUpperCase(),
+    path,
+    queryString,
+    canonicalHeaders,
+    signedHeaders,
+    payloadHash
+  ].join('\n');
+
+  const credentialScope = `${dateStamp}/${region}/${service}/aws4_request`;
+  const stringToSign = [
+    'AWS4-HMAC-SHA256',
+    amzDate,
+    credentialScope,
+    crypto.createHash('sha256').update(canonicalRequest).digest('hex')
+  ].join('\n');
+
+  const signingKey = getSigningKey(secretAccessKey, dateStamp, region, service);
+  const signature = crypto.createHmac('sha256', signingKey).update(stringToSign).digest('hex');
+
+  const authorization = `AWS4-HMAC-SHA256 Credential=${accessKeyId}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
+
+  return { authorization, amzDate };
+}
+
+function getBatchClient() {
+  const accessKeyId = getConfig('accessKeyId');
+  const secretAccessKey = getConfig('secretAccessKey');
+  const region = getConfig('region') || 'us-east-1';
+  const baseURL = `https://batch.${region}.amazonaws.com`;
+
+  return {
+    request: async (method, path, data = null) => {
+      const url = `${baseURL}${path}`;
+      const body = data ? JSON.stringify(data) : '';
+      const { authorization, amzDate } = buildAuthHeader({
+        method,
+        url,
+        body,
+        service: 'batch',
+        region,
+        accessKeyId,
+        secretAccessKey
+      });
+
+      try {
+        const response = await axios({
+          method,
+          url,
+          data: data || undefined,
+          headers: {
+            'Authorization': authorization,
+            'X-Amz-Date': amzDate,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json'
+          }
+        });
+        return response.data;
+      } catch (error) {
+        handleApiError(error);
+      }
+    }
+  };
+}
+
+function handleApiError(error) {
+  if (error.response) {
+    const status = error.response.status;
+    const data = error.response.data;
+    if (status === 401 || status === 403) {
+      throw new Error('AWS authentication failed. Check your accessKeyId and secretAccessKey.');
+    } else if (status === 404) {
+      throw new Error('Resource not found.');
+    } else if (status === 429) {
+      throw new Error('Rate limit exceeded. Please wait before retrying.');
+    } else {
+      const message = data?.message || data?.Message || data?.error || JSON.stringify(data);
+      throw new Error(`AWS Batch Error (${status}): ${message}`);
+    }
+  } else if (error.request) {
+    throw new Error('No response from AWS Batch API. Check your internet connection and region.');
+  } else {
+    throw error;
+  }
+}
+
+// ============================================================
+// JOBS
+// ============================================================
+
+export async function submitJob({ jobName, jobQueue, jobDefinition, parameters, containerOverrides }) {
+  const client = getBatchClient();
+  const body = {
+    jobName,
+    jobQueue,
+    jobDefinition,
+    ...(parameters && { parameters }),
+    ...(containerOverrides && { containerOverrides })
+  };
+  const data = await client.request('POST', '/v1/submitjob', body);
+  return data;
+}
+
+export async function describeJobs(jobIds) {
+  const client = getBatchClient();
+  const data = await client.request('POST', '/v1/describejobs', { jobs: jobIds });
+  return data?.jobs || [];
+}
+
+export async function listJobs({ jobQueue, jobStatus, maxResults = 50 } = {}) {
+  const client = getBatchClient();
+  const body = {};
+  if (jobQueue) body.jobQueue = jobQueue;
+  if (jobStatus) body.jobStatus = jobStatus;
+  if (maxResults) body.maxResults = maxResults;
+  const data = await client.request('POST', '/v1/listjobs', body);
+  return data?.jobSummaryList || [];
+}
+
+export async function terminateJob(jobId, reason) {
+  const client = getBatchClient();
+  const data = await client.request('POST', '/v1/terminatejob', {
+    jobId,
+    reason: reason || 'Terminated via CLI'
+  });
+  return data;
+}
+
+// ============================================================
+// JOB QUEUES
+// ============================================================
+
+export async function listQueues() {
+  const client = getBatchClient();
+  const data = await client.request('GET', '/v1/jobqueues');
+  return data?.jobQueues || [];
+}
+
+export async function getQueue(queueName) {
+  const client = getBatchClient();
+  const data = await client.request('GET', `/v1/jobqueues?jobQueues=${encodeURIComponent(queueName)}`);
+  return (data?.jobQueues || [])[0] || null;
+}
+
+export async function createQueue({ queueName, state, priority, computeEnvironmentOrder }) {
+  const client = getBatchClient();
+  const body = {
+    jobQueueName: queueName,
+    state: state || 'ENABLED',
+    priority: priority || 1,
+    computeEnvironmentOrder: computeEnvironmentOrder || []
+  };
+  const data = await client.request('POST', '/v1/createjobqueue', body);
+  return data;
+}
+
+export async function updateQueue({ queueName, state, priority }) {
+  const client = getBatchClient();
+  const body = { jobQueue: queueName };
+  if (state) body.state = state;
+  if (priority !== undefined) body.priority = priority;
+  const data = await client.request('POST', '/v1/updatejobqueue', body);
+  return data;
+}
+
+// ============================================================
+// JOB DEFINITIONS
+// ============================================================
+
+export async function listDefinitions({ definitionName, status } = {}) {
+  const client = getBatchClient();
+  let path = '/v1/jobdefinitions';
+  const params = [];
+  if (definitionName) params.push(`jobDefinitionName=${encodeURIComponent(definitionName)}`);
+  if (status) params.push(`status=${encodeURIComponent(status)}`);
+  if (params.length) path += '?' + params.join('&');
+  const data = await client.request('GET', path);
+  return data?.jobDefinitions || [];
+}
+
+export async function describeDefinitions(definitionNames) {
+  const client = getBatchClient();
+  const path = `/v1/jobdefinitions?jobDefinitionName=${encodeURIComponent(definitionNames[0])}`;
+  const data = await client.request('GET', path);
+  return data?.jobDefinitions || [];
+}
+
+export async function registerDefinition({ definitionName, type, containerProperties }) {
+  const client = getBatchClient();
+  const body = {
+    jobDefinitionName: definitionName,
+    type: type || 'container',
+    ...(containerProperties && { containerProperties })
+  };
+  const data = await client.request('POST', '/v1/registerjobdefinition', body);
+  return data;
+}

package/src/config.js

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

package/src/index.js

@@ -0,0 +1,576 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { getConfig, setConfig, getAllConfig, isConfigured } from './config.js';
+import {
+  submitJob,
+  describeJobs,
+  listJobs,
+  terminateJob,
+  listQueues,
+  getQueue,
+  createQueue,
+  updateQueue,
+  listDefinitions,
+  describeDefinitions,
+  registerDefinition
+} 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], 40);
+  });
+
+  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('AWS credentials not configured.');
+    console.log('\nRun the following to configure:');
+    console.log(chalk.cyan('  awsbatch config set accessKeyId YOUR_KEY'));
+    console.log(chalk.cyan('  awsbatch config set secretAccessKey YOUR_SECRET'));
+    console.log(chalk.cyan('  awsbatch config set region us-east-1'));
+    process.exit(1);
+  }
+}
+
+// ============================================================
+// Program metadata
+// ============================================================
+
+program
+  .name('awsbatch')
+  .description(chalk.bold('AWS Batch CLI') + ' - Manage batch computing jobs from your terminal')
+  .version('1.0.0');
+
+// ============================================================
+// CONFIG
+// ============================================================
+
+const configCmd = program.command('config').description('Manage CLI configuration');
+
+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('set <key> <value>')
+  .description('Set a configuration value')
+  .action((key, value) => {
+    setConfig(key, value);
+    printSuccess(`Config '${key}' set`);
+  });
+
+configCmd
+  .command('list')
+  .description('List all configuration values')
+  .action(() => {
+    const all = getAllConfig();
+    console.log(chalk.bold('\nAWS Batch CLI Configuration\n'));
+    if (Object.keys(all).length === 0) {
+      console.log(chalk.yellow('No configuration set.'));
+      console.log('\nRun:');
+      console.log(chalk.cyan('  awsbatch config set accessKeyId YOUR_KEY'));
+      console.log(chalk.cyan('  awsbatch config set secretAccessKey YOUR_SECRET'));
+      console.log(chalk.cyan('  awsbatch config set region us-east-1'));
+    } else {
+      Object.entries(all).forEach(([k, v]) => {
+        const displayVal = k === 'secretAccessKey' ? chalk.green('*'.repeat(8)) : chalk.cyan(String(v));
+        console.log(`${k}: ${displayVal}`);
+      });
+    }
+  });
+
+// ============================================================
+// JOBS
+// ============================================================
+
+const jobsCmd = program.command('jobs').description('Manage AWS Batch jobs');
+
+jobsCmd
+  .command('submit')
+  .description('Submit a new batch job')
+  .requiredOption('--name <name>', 'Job name')
+  .requiredOption('--queue <queue>', 'Job queue name or ARN')
+  .requiredOption('--definition <def>', 'Job definition name or ARN')
+  .option('--parameters <json>', 'Job parameters as JSON')
+  .option('--container-overrides <json>', 'Container overrides as JSON')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+
+    let parameters, containerOverrides;
+    if (options.parameters) {
+      try { parameters = JSON.parse(options.parameters); } catch { printError('Invalid JSON for --parameters'); process.exit(1); }
+    }
+    if (options.containerOverrides) {
+      try { containerOverrides = JSON.parse(options.containerOverrides); } catch { printError('Invalid JSON for --container-overrides'); process.exit(1); }
+    }
+
+    try {
+      const result = await withSpinner('Submitting job...', () =>
+        submitJob({
+          jobName: options.name,
+          jobQueue: options.queue,
+          jobDefinition: options.definition,
+          parameters,
+          containerOverrides
+        })
+      );
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      printSuccess('Job submitted');
+      console.log('Job ID:    ', chalk.cyan(result?.jobId || 'N/A'));
+      console.log('Job Name:  ', result?.jobName || options.name);
+      console.log('Job ARN:   ', result?.jobArn || 'N/A');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+jobsCmd
+  .command('get <job-id>')
+  .description('Get job details')
+  .option('--json', 'Output as JSON')
+  .action(async (jobId, options) => {
+    requireAuth();
+    try {
+      const jobs = await withSpinner(`Fetching job ${jobId}...`, () => describeJobs([jobId]));
+      const job = jobs[0];
+
+      if (!job) {
+        printError('Job not found');
+        process.exit(1);
+      }
+
+      if (options.json) {
+        printJson(job);
+        return;
+      }
+
+      const statusColor = job.status === 'SUCCEEDED' ? chalk.green : job.status === 'FAILED' ? chalk.red : chalk.yellow;
+
+      console.log(chalk.bold('\nJob Details\n'));
+      console.log('Job ID:          ', chalk.cyan(job.jobId));
+      console.log('Job Name:        ', chalk.bold(job.jobName));
+      console.log('Status:          ', statusColor(job.status || 'N/A'));
+      console.log('Queue:           ', job.jobQueue || 'N/A');
+      console.log('Definition:      ', job.jobDefinition || 'N/A');
+      console.log('Created:         ', job.createdAt ? new Date(job.createdAt).toLocaleString() : 'N/A');
+      console.log('Started:         ', job.startedAt ? new Date(job.startedAt).toLocaleString() : 'N/A');
+      console.log('Stopped:         ', job.stoppedAt ? new Date(job.stoppedAt).toLocaleString() : 'N/A');
+      if (job.statusReason) console.log('Status Reason:   ', chalk.dim(job.statusReason));
+      if (job.container?.exitCode !== undefined) console.log('Exit Code:       ', job.container.exitCode);
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+jobsCmd
+  .command('list')
+  .description('List jobs in a queue')
+  .requiredOption('--queue <queue>', 'Job queue name')
+  .option('--status <status>', 'Filter by status (SUBMITTED|PENDING|RUNNABLE|STARTING|RUNNING|SUCCEEDED|FAILED)')
+  .option('--limit <n>', 'Maximum number of results', '50')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const jobs = await withSpinner('Fetching jobs...', () =>
+        listJobs({
+          jobQueue: options.queue,
+          jobStatus: options.status,
+          maxResults: parseInt(options.limit)
+        })
+      );
+
+      if (options.json) {
+        printJson(jobs);
+        return;
+      }
+
+      printTable(jobs, [
+        { key: 'jobId', label: 'Job ID', format: (v) => v ? String(v).substring(0, 16) + '...' : '' },
+        { key: 'jobName', label: 'Name' },
+        { key: 'status', label: 'Status' },
+        { key: 'createdAt', label: 'Created', format: (v) => v ? new Date(v).toLocaleDateString() : '' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+jobsCmd
+  .command('terminate <job-id>')
+  .description('Terminate a job')
+  .option('--reason <reason>', 'Termination reason', 'Terminated via CLI')
+  .action(async (jobId, options) => {
+    requireAuth();
+    try {
+      await withSpinner(`Terminating job ${jobId}...`, () =>
+        terminateJob(jobId, options.reason)
+      );
+      printSuccess(`Job ${jobId} terminated`);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+jobsCmd
+  .command('describe <job-ids...>')
+  .description('Describe one or more jobs by ID')
+  .option('--json', 'Output as JSON')
+  .action(async (jobIds, options) => {
+    requireAuth();
+    try {
+      const jobs = await withSpinner('Fetching job details...', () => describeJobs(jobIds));
+
+      if (options.json) {
+        printJson(jobs);
+        return;
+      }
+
+      printTable(jobs, [
+        { key: 'jobId', label: 'Job ID', format: (v) => v ? String(v).substring(0, 16) + '...' : '' },
+        { key: 'jobName', label: 'Name' },
+        { key: 'status', label: 'Status' },
+        { key: 'jobQueue', label: 'Queue', format: (v) => (v || '').split('/').pop() },
+        { key: 'createdAt', label: 'Created', format: (v) => v ? new Date(v).toLocaleDateString() : '' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// QUEUES
+// ============================================================
+
+const queuesCmd = program.command('queues').description('Manage AWS Batch job queues');
+
+queuesCmd
+  .command('list')
+  .description('List job queues')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const queues = await withSpinner('Fetching job queues...', () => listQueues());
+
+      if (options.json) {
+        printJson(queues);
+        return;
+      }
+
+      printTable(queues, [
+        { key: 'jobQueueName', label: 'Name' },
+        { key: 'state', label: 'State' },
+        { key: 'status', label: 'Status' },
+        { key: 'priority', label: 'Priority', format: (v) => String(v || 0) }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+queuesCmd
+  .command('get <queue-name>')
+  .description('Get job queue details')
+  .option('--json', 'Output as JSON')
+  .action(async (queueName, options) => {
+    requireAuth();
+    try {
+      const queue = await withSpinner(`Fetching queue ${queueName}...`, () => getQueue(queueName));
+
+      if (!queue) {
+        printError('Queue not found');
+        process.exit(1);
+      }
+
+      if (options.json) {
+        printJson(queue);
+        return;
+      }
+
+      console.log(chalk.bold('\nJob Queue Details\n'));
+      console.log('Name:          ', chalk.cyan(queue.jobQueueName));
+      console.log('ARN:           ', queue.jobQueueArn || 'N/A');
+      console.log('State:         ', queue.state || 'N/A');
+      console.log('Status:        ', queue.status || 'N/A');
+      console.log('Priority:      ', queue.priority !== undefined ? String(queue.priority) : 'N/A');
+      if (queue.statusReason) console.log('Status Reason: ', queue.statusReason);
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+queuesCmd
+  .command('create')
+  .description('Create a new job queue')
+  .requiredOption('--name <name>', 'Queue name')
+  .option('--state <state>', 'Queue state (ENABLED|DISABLED)', 'ENABLED')
+  .option('--priority <n>', 'Queue priority (1-1000)', '1')
+  .option('--compute-envs <json>', 'Compute environment order as JSON array')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+
+    let computeEnvironmentOrder = [];
+    if (options.computeEnvs) {
+      try { computeEnvironmentOrder = JSON.parse(options.computeEnvs); } catch { printError('Invalid JSON for --compute-envs'); process.exit(1); }
+    }
+
+    try {
+      const result = await withSpinner('Creating job queue...', () =>
+        createQueue({
+          queueName: options.name,
+          state: options.state,
+          priority: parseInt(options.priority),
+          computeEnvironmentOrder
+        })
+      );
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      printSuccess(`Queue '${options.name}' created`);
+      if (result) {
+        console.log('Queue ARN: ', result.jobQueueArn || 'N/A');
+      }
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+queuesCmd
+  .command('update <queue-name>')
+  .description('Update a job queue')
+  .option('--state <state>', 'Queue state (ENABLED|DISABLED)')
+  .option('--priority <n>', 'Queue priority')
+  .option('--json', 'Output as JSON')
+  .action(async (queueName, options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner(`Updating queue ${queueName}...`, () =>
+        updateQueue({
+          queueName,
+          state: options.state,
+          priority: options.priority ? parseInt(options.priority) : undefined
+        })
+      );
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      printSuccess(`Queue '${queueName}' updated`);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// DEFINITIONS
+// ============================================================
+
+const definitionsCmd = program.command('definitions').description('Manage AWS Batch job definitions');
+
+definitionsCmd
+  .command('list')
+  .description('List job definitions')
+  .option('--name <name>', 'Filter by definition name')
+  .option('--status <status>', 'Filter by status (ACTIVE|INACTIVE)', 'ACTIVE')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const definitions = await withSpinner('Fetching job definitions...', () =>
+        listDefinitions({ definitionName: options.name, status: options.status })
+      );
+
+      if (options.json) {
+        printJson(definitions);
+        return;
+      }
+
+      printTable(definitions, [
+        { key: 'jobDefinitionName', label: 'Name' },
+        { key: 'revision', label: 'Rev', format: (v) => String(v || '') },
+        { key: 'type', label: 'Type' },
+        { key: 'status', label: 'Status' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+definitionsCmd
+  .command('register')
+  .description('Register a new job definition')
+  .requiredOption('--name <name>', 'Job definition name')
+  .option('--type <type>', 'Job type (container|multinode)', 'container')
+  .option('--container <json>', 'Container properties as JSON')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+
+    let containerProperties;
+    if (options.container) {
+      try { containerProperties = JSON.parse(options.container); } catch { printError('Invalid JSON for --container'); process.exit(1); }
+    }
+
+    try {
+      const result = await withSpinner('Registering job definition...', () =>
+        registerDefinition({
+          definitionName: options.name,
+          type: options.type,
+          containerProperties
+        })
+      );
+
+      if (options.json) {
+        printJson(result);
+        return;
+      }
+
+      printSuccess(`Job definition '${options.name}' registered`);
+      if (result) {
+        console.log('ARN:      ', result.jobDefinitionArn || 'N/A');
+        console.log('Revision: ', result.revision !== undefined ? String(result.revision) : 'N/A');
+      }
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+definitionsCmd
+  .command('describe <definition-name>')
+  .description('Describe a job definition')
+  .option('--json', 'Output as JSON')
+  .action(async (definitionName, options) => {
+    requireAuth();
+    try {
+      const definitions = await withSpinner(`Fetching definition ${definitionName}...`, () =>
+        describeDefinitions([definitionName])
+      );
+
+      if (options.json) {
+        printJson(definitions);
+        return;
+      }
+
+      if (!definitions || definitions.length === 0) {
+        printError('Job definition not found');
+        process.exit(1);
+      }
+
+      const def = definitions[0];
+      console.log(chalk.bold('\nJob Definition Details\n'));
+      console.log('Name:      ', chalk.cyan(def.jobDefinitionName));
+      console.log('ARN:       ', def.jobDefinitionArn || 'N/A');
+      console.log('Revision:  ', def.revision !== undefined ? String(def.revision) : 'N/A');
+      console.log('Type:      ', def.type || 'N/A');
+      console.log('Status:    ', def.status || 'N/A');
+      if (def.containerProperties) {
+        console.log('Image:     ', def.containerProperties.image || 'N/A');
+        console.log('vCPUs:     ', def.containerProperties.vcpus || 'N/A');
+        console.log('Memory:    ', def.containerProperties.memory ? `${def.containerProperties.memory} MB` : 'N/A');
+      }
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// Parse
+// ============================================================
+
+program.parse(process.argv);
+
+if (process.argv.length <= 2) {
+  program.help();
+}