@ktmcp-cli/alertersystem 1.0.0

package/AGENT.md

@@ -0,0 +1,40 @@
+# Alerter System CLI - AI Agent Guide
+
+This CLI provides programmatic access to the Alerter System Monitoring API.
+
+## Quick Start for AI Agents
+
+```bash
+alertersystem config set --token YOUR_TOKEN
+alertersystem alerts list
+alertersystem monitors list
+```
+
+## Available Commands
+
+### config
+- `alertersystem config set --token <token>` - Set bearer token
+- `alertersystem config get <key>` - Get config value
+- `alertersystem config list` - Show all config
+
+### alerts
+- `alertersystem alerts list [--status open|acknowledged|resolved]` - List alerts
+- `alertersystem alerts get <alert-id>` - Get alert details
+- `alertersystem alerts acknowledge <alert-id>` - Acknowledge alert
+- `alertersystem alerts resolve <alert-id>` - Resolve alert
+
+### monitors
+- `alertersystem monitors list` - List all monitors
+- `alertersystem monitors get <monitor-id>` - Get monitor details
+- `alertersystem monitors create --name <name> --url <url> [--interval <seconds>] [--type http|https|tcp|ping]` - Create monitor
+- `alertersystem monitors delete <monitor-id>` - Delete monitor
+
+### notifications
+- `alertersystem notifications list` - List all notifications
+- `alertersystem notifications get <notification-id>` - Get notification details
+
+## Tips for Agents
+
+- All commands support `--json` for machine-readable output
+- Filter critical alerts: `alertersystem alerts list --json | jq '.[] | select(.severity == "critical")'`
+- Acknowledge all open alerts: `alertersystem alerts list --status open --json | jq -r '.[].id' | xargs -I{} alertersystem alerts acknowledge {}`

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,133 @@
+> "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/)
+
+# Alerter System CLI
+
+Production-ready CLI for the [Alerter System](https://alertersystem.com) Monitoring API. Manage alerts, monitors, and notifications directly from your terminal.
+
+> **Disclaimer**: This is an unofficial CLI tool and is not affiliated with, endorsed by, or supported by Alerter System.
+
+## Installation
+
+```bash
+npm install -g @ktmcp-cli/alertersystem
+```
+
+## Configuration
+
+```bash
+alertersystem config set --token YOUR_BEARER_TOKEN
+```
+
+Get your API token at [alertersystem.com](https://alertersystem.com).
+
+## Usage
+
+### Configuration
+
+```bash
+# Set bearer token
+alertersystem config set --token YOUR_BEARER_TOKEN
+
+# Show configuration
+alertersystem config list
+
+# Get a specific config value
+alertersystem config get token
+```
+
+### Alerts
+
+```bash
+# List all alerts
+alertersystem alerts list
+
+# Filter by status
+alertersystem alerts list --status open
+alertersystem alerts list --status acknowledged
+alertersystem alerts list --status resolved
+
+# Get a specific alert
+alertersystem alerts get ALERT_ID
+
+# Acknowledge an alert
+alertersystem alerts acknowledge ALERT_ID
+
+# Resolve an alert
+alertersystem alerts resolve ALERT_ID
+```
+
+### Monitors
+
+```bash
+# List all monitors
+alertersystem monitors list
+
+# Get a specific monitor
+alertersystem monitors get MONITOR_ID
+
+# Create a new monitor
+alertersystem monitors create \
+  --name "My Website" \
+  --url https://example.com \
+  --interval 60 \
+  --type https
+
+# Delete a monitor
+alertersystem monitors delete MONITOR_ID
+```
+
+### Notifications
+
+```bash
+# List all notifications
+alertersystem notifications list
+
+# Get a specific notification
+alertersystem notifications get NOTIFICATION_ID
+```
+
+### JSON Output
+
+All commands support `--json` for machine-readable output:
+
+```bash
+# List open alerts as JSON
+alertersystem alerts list --status open --json
+
+# Pipe to jq
+alertersystem alerts list --json | jq '.[] | select(.severity == "critical") | {id, name}'
+
+# Get monitor status
+alertersystem monitors list --json | jq '.[] | {name, status, uptime}'
+```
+
+## Examples
+
+```bash
+# Morning ops check: see all open alerts
+alertersystem alerts list --status open
+
+# Acknowledge all critical alerts
+alertersystem alerts list --json | jq -r '.[] | select(.severity == "critical") | .id' | \
+  xargs -I{} alertersystem alerts acknowledge {}
+
+# Create a monitor for your API
+alertersystem monitors create --name "Production API" --url https://api.example.com/health --interval 30
+
+# Check monitor uptime
+alertersystem monitors list --json | jq '.[] | {name, uptime: .uptime}'
+
+# Count unread notifications
+alertersystem notifications list --json | jq '[.[] | select(.read == false)] | length'
+```
+
+## License
+
+MIT
+
+---
+
+Part of the [KTMCP CLI](https://killthemcp.com) project — replacing MCPs with simple, composable CLIs.

package/bin/alertersystem.js

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@ktmcp-cli/alertersystem",
+  "version": "1.0.0",
+  "description": "Production-ready CLI for Alerter System Monitoring API - Kill The MCP",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "alertersystem": "bin/alertersystem.js"
+  },
+  "keywords": ["alertersystem", "monitoring", "alerts", "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/alertersystem.git"
+  },
+  "homepage": "https://killthemcp.com/alertersystem-cli",
+  "bugs": { "url": "https://github.com/ktmcp-cli/alertersystem/issues" }
+}

package/src/api.js

@@ -0,0 +1,138 @@
+import axios from 'axios';
+import { getConfig } from './config.js';
+
+const BASE_URL = 'https://api.alertersystem.com';
+
+function getToken() {
+  const token = getConfig('token');
+  if (!token) {
+    throw new Error('Bearer token not configured. Run: alertersystem config set token YOUR_TOKEN');
+  }
+  return token;
+}
+
+function handleApiError(error) {
+  if (error.response) {
+    const status = error.response.status;
+    const data = error.response.data;
+    if (status === 401 || status === 403) {
+      throw new Error('Authentication failed. Check your token: alertersystem config set token YOUR_TOKEN');
+    } else if (status === 429) {
+      throw new Error('Rate limit exceeded. Please wait before retrying.');
+    } else if (status === 404) {
+      throw new Error('Resource not found.');
+    } else {
+      const message = data?.error || data?.message || JSON.stringify(data);
+      throw new Error(`API Error (${status}): ${message}`);
+    }
+  } else if (error.request) {
+    throw new Error('No response from Alerter System API. Check your internet connection.');
+  } else {
+    throw error;
+  }
+}
+
+function getHeaders() {
+  return {
+    'Authorization': `Bearer ${getToken()}`,
+    'Content-Type': 'application/json',
+    'Accept': 'application/json'
+  };
+}
+
+async function apiGet(path, params = {}) {
+  try {
+    const response = await axios.get(`${BASE_URL}${path}`, {
+      headers: getHeaders(),
+      params
+    });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+async function apiPost(path, data = {}) {
+  try {
+    const response = await axios.post(`${BASE_URL}${path}`, data, {
+      headers: getHeaders()
+    });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+async function apiDelete(path) {
+  try {
+    const response = await axios.delete(`${BASE_URL}${path}`, {
+      headers: getHeaders()
+    });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+async function apiPatch(path, data = {}) {
+  try {
+    const response = await axios.patch(`${BASE_URL}${path}`, data, {
+      headers: getHeaders()
+    });
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}
+
+// ============================================================
+// ALERTS
+// ============================================================
+
+export async function listAlerts(params = {}) {
+  return await apiGet('/alerts', params);
+}
+
+export async function getAlert(alertId) {
+  return await apiGet(`/alerts/${alertId}`);
+}
+
+export async function acknowledgeAlert(alertId) {
+  return await apiPatch(`/alerts/${alertId}/acknowledge`, {});
+}
+
+export async function resolveAlert(alertId) {
+  return await apiPatch(`/alerts/${alertId}/resolve`, {});
+}
+
+// ============================================================
+// MONITORS
+// ============================================================
+
+export async function listMonitors(params = {}) {
+  return await apiGet('/monitors', params);
+}
+
+export async function getMonitor(monitorId) {
+  return await apiGet(`/monitors/${monitorId}`);
+}
+
+export async function createMonitor({ name, url, interval, type }) {
+  return await apiPost('/monitors', { name, url, interval, type });
+}
+
+export async function deleteMonitor(monitorId) {
+  return await apiDelete(`/monitors/${monitorId}`);
+}
+
+// ============================================================
+// NOTIFICATIONS
+// ============================================================
+
+export async function listNotifications(params = {}) {
+  return await apiGet('/notifications', params);
+}
+
+export async function getNotification(notificationId) {
+  return await apiGet(`/notifications/${notificationId}`);
+}

package/src/config.js

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

package/src/index.js

@@ -0,0 +1,405 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { getConfig, setConfig, isConfigured, getAllConfig } from './config.js';
+import {
+  listAlerts,
+  getAlert,
+  acknowledgeAlert,
+  resolveAlert,
+  listMonitors,
+  getMonitor,
+  createMonitor,
+  deleteMonitor,
+  listNotifications,
+  getNotification
+} 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('Alerter System token not configured.');
+    console.log('\nRun the following to configure:');
+    console.log(chalk.cyan('  alertersystem config set token YOUR_BEARER_TOKEN'));
+    process.exit(1);
+  }
+}
+
+function alertStatusColor(status) {
+  switch ((status || '').toLowerCase()) {
+    case 'open': case 'firing': case 'critical': return chalk.red(status);
+    case 'acknowledged': return chalk.yellow(status);
+    case 'resolved': case 'closed': return chalk.green(status);
+    default: return status;
+  }
+}
+
+function monitorStatusColor(status) {
+  switch ((status || '').toLowerCase()) {
+    case 'up': case 'ok': case 'operational': return chalk.green(status);
+    case 'down': case 'error': case 'critical': return chalk.red(status);
+    case 'degraded': case 'warning': return chalk.yellow(status);
+    default: return status;
+  }
+}
+
+// ============================================================
+// Program metadata
+// ============================================================
+
+program
+  .name('alertersystem')
+  .description(chalk.bold('Alerter System CLI') + ' - System monitoring 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('--token <token>', 'Alerter System Bearer token')
+  .action((options) => {
+    if (options.token) {
+      setConfig('token', options.token);
+      printSuccess('Token set');
+    } else {
+      printError('No options provided. Use --token');
+    }
+  });
+
+configCmd
+  .command('get')
+  .description('Get a configuration value')
+  .argument('<key>', 'Config key to retrieve')
+  .action((key) => {
+    const value = getConfig(key);
+    if (value === undefined || value === null || value === '') {
+      console.log(chalk.yellow(`${key}: not set`));
+    } else {
+      const masked = key.toLowerCase().includes('token') ? '*'.repeat(8) : value;
+      console.log(`${key}: ${chalk.green(masked)}`);
+    }
+  });
+
+configCmd
+  .command('list')
+  .description('List all configuration values')
+  .action(() => {
+    const all = getAllConfig();
+    console.log(chalk.bold('\nAlerter System CLI Configuration\n'));
+    console.log('Token:', all.token ? chalk.green('*'.repeat(8)) : chalk.red('not set'));
+    console.log('');
+  });
+
+// ============================================================
+// ALERTS
+// ============================================================
+
+const alertsCmd = program.command('alerts').description('Manage system alerts');
+
+alertsCmd
+  .command('list')
+  .description('List all alerts')
+  .option('--status <status>', 'Filter by status (open|acknowledged|resolved)')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const params = options.status ? { status: options.status } : {};
+      const data = await withSpinner('Fetching alerts...', () => listAlerts(params));
+      if (options.json) { printJson(data); return; }
+      const list = Array.isArray(data) ? data : (data?.alerts || data?.data || []);
+      printTable(list, [
+        { key: 'id', label: 'ID' },
+        { key: 'name', label: 'Name' },
+        { key: 'severity', label: 'Severity', format: (v) => v ? chalk.bold(v) : 'N/A' },
+        { key: 'status', label: 'Status', format: (v) => alertStatusColor(v) },
+        { key: 'monitor', label: 'Monitor', format: (v, row) => v || row.monitor_name || 'N/A' },
+        { key: 'created_at', label: 'Created' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+alertsCmd
+  .command('get <alert-id>')
+  .description('Get details of a specific alert')
+  .option('--json', 'Output as JSON')
+  .action(async (alertId, options) => {
+    requireAuth();
+    try {
+      const alert = await withSpinner('Fetching alert...', () => getAlert(alertId));
+      if (options.json) { printJson(alert); return; }
+      console.log(chalk.bold('\nAlert Details\n'));
+      console.log('ID:          ', chalk.cyan(alert.id || alertId));
+      console.log('Name:        ', chalk.bold(alert.name || 'N/A'));
+      console.log('Status:      ', alertStatusColor(alert.status));
+      console.log('Severity:    ', alert.severity || 'N/A');
+      console.log('Monitor:     ', alert.monitor || alert.monitor_name || 'N/A');
+      console.log('Message:     ', alert.message || alert.description || 'N/A');
+      console.log('Created:     ', alert.created_at || 'N/A');
+      if (alert.resolved_at) console.log('Resolved:    ', alert.resolved_at);
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+alertsCmd
+  .command('acknowledge <alert-id>')
+  .description('Acknowledge an alert')
+  .option('--json', 'Output as JSON')
+  .action(async (alertId, options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner('Acknowledging alert...', () => acknowledgeAlert(alertId));
+      if (options.json) { printJson(result); return; }
+      printSuccess(`Alert ${chalk.cyan(alertId)} acknowledged`);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+alertsCmd
+  .command('resolve <alert-id>')
+  .description('Resolve an alert')
+  .option('--json', 'Output as JSON')
+  .action(async (alertId, options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner('Resolving alert...', () => resolveAlert(alertId));
+      if (options.json) { printJson(result); return; }
+      printSuccess(`Alert ${chalk.cyan(alertId)} resolved`);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// MONITORS
+// ============================================================
+
+const monitorsCmd = program.command('monitors').description('Manage uptime monitors');
+
+monitorsCmd
+  .command('list')
+  .description('List all monitors')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const data = await withSpinner('Fetching monitors...', () => listMonitors());
+      if (options.json) { printJson(data); return; }
+      const list = Array.isArray(data) ? data : (data?.monitors || data?.data || []);
+      printTable(list, [
+        { key: 'id', label: 'ID' },
+        { key: 'name', label: 'Name' },
+        { key: 'url', label: 'URL' },
+        { key: 'type', label: 'Type' },
+        { key: 'status', label: 'Status', format: (v) => monitorStatusColor(v) },
+        { key: 'interval', label: 'Interval', format: (v) => v ? `${v}s` : 'N/A' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+monitorsCmd
+  .command('get <monitor-id>')
+  .description('Get details of a specific monitor')
+  .option('--json', 'Output as JSON')
+  .action(async (monitorId, options) => {
+    requireAuth();
+    try {
+      const monitor = await withSpinner('Fetching monitor...', () => getMonitor(monitorId));
+      if (options.json) { printJson(monitor); return; }
+      console.log(chalk.bold('\nMonitor Details\n'));
+      console.log('ID:          ', chalk.cyan(monitor.id || monitorId));
+      console.log('Name:        ', chalk.bold(monitor.name || 'N/A'));
+      console.log('URL:         ', monitor.url || 'N/A');
+      console.log('Type:        ', monitor.type || 'N/A');
+      console.log('Status:      ', monitorStatusColor(monitor.status));
+      console.log('Interval:    ', monitor.interval ? `${monitor.interval}s` : 'N/A');
+      console.log('Created:     ', monitor.created_at || 'N/A');
+      if (monitor.last_checked) console.log('Last Check:  ', monitor.last_checked);
+      if (monitor.uptime) console.log('Uptime:      ', `${monitor.uptime}%`);
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+monitorsCmd
+  .command('create')
+  .description('Create a new uptime monitor')
+  .requiredOption('--name <name>', 'Monitor name')
+  .requiredOption('--url <url>', 'URL to monitor')
+  .option('--interval <seconds>', 'Check interval in seconds', '60')
+  .option('--type <type>', 'Monitor type (http|https|tcp|ping)', 'https')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const monitor = await withSpinner('Creating monitor...', () =>
+        createMonitor({
+          name: options.name,
+          url: options.url,
+          interval: parseInt(options.interval),
+          type: options.type
+        })
+      );
+      if (options.json) { printJson(monitor); return; }
+      printSuccess(`Monitor created: ${chalk.bold(options.name)}`);
+      console.log('Monitor ID:', chalk.cyan(monitor.id || 'N/A'));
+      console.log('URL:       ', options.url);
+      console.log('Interval:  ', `${options.interval}s`);
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+monitorsCmd
+  .command('delete <monitor-id>')
+  .description('Delete a monitor')
+  .option('--json', 'Output as JSON')
+  .action(async (monitorId, options) => {
+    requireAuth();
+    try {
+      const result = await withSpinner('Deleting monitor...', () => deleteMonitor(monitorId));
+      if (options.json) { printJson(result || { deleted: true }); return; }
+      printSuccess(`Monitor ${chalk.cyan(monitorId)} deleted`);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// NOTIFICATIONS
+// ============================================================
+
+const notificationsCmd = program.command('notifications').description('View notifications');
+
+notificationsCmd
+  .command('list')
+  .description('List all notifications')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    requireAuth();
+    try {
+      const data = await withSpinner('Fetching notifications...', () => listNotifications());
+      if (options.json) { printJson(data); return; }
+      const list = Array.isArray(data) ? data : (data?.notifications || data?.data || []);
+      printTable(list, [
+        { key: 'id', label: 'ID' },
+        { key: 'type', label: 'Type' },
+        { key: 'message', label: 'Message' },
+        { key: 'read', label: 'Read', format: (v) => v ? chalk.dim('Yes') : chalk.bold('No') },
+        { key: 'created_at', label: 'Created' }
+      ]);
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+notificationsCmd
+  .command('get <notification-id>')
+  .description('Get details of a specific notification')
+  .option('--json', 'Output as JSON')
+  .action(async (notificationId, options) => {
+    requireAuth();
+    try {
+      const notification = await withSpinner('Fetching notification...', () => getNotification(notificationId));
+      if (options.json) { printJson(notification); return; }
+      console.log(chalk.bold('\nNotification Details\n'));
+      console.log('ID:       ', chalk.cyan(notification.id || notificationId));
+      console.log('Type:     ', notification.type || 'N/A');
+      console.log('Message:  ', notification.message || 'N/A');
+      console.log('Read:     ', notification.read ? chalk.dim('Yes') : chalk.bold('No'));
+      console.log('Created:  ', notification.created_at || 'N/A');
+      console.log('');
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
+
+// ============================================================
+// Parse
+// ============================================================
+
+program.parse(process.argv);
+
+if (process.argv.length <= 2) {
+  program.help();
+}