@n8n/cli 0.1.0

package/dist/output.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatOutput = formatOutput;
+exports.applyJqFilter = applyJqFilter;
+function pickColumns(data, columns) {
+    const result = {};
+    for (const col of columns) {
+        result[col] = data[col];
+    }
+    return result;
+}
+function formatValue(value) {
+    if (value === null || value === undefined)
+        return '-';
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (typeof value === 'string') {
+        return value.length > 60 ? value.slice(0, 57) + '...' : value;
+    }
+    if (typeof value === 'number')
+        return String(value);
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return typeof value === 'bigint' ? String(value) : JSON.stringify(value);
+}
+function renderTable(data, columns, noHeader) {
+    if (data.length === 0)
+        return 'No results.';
+    const cols = columns ?? Object.keys(data[0]);
+    const rows = data.map((row) => pickColumns(row, cols));
+    const widths = {};
+    for (const col of cols) {
+        widths[col] = col.length;
+        for (const row of rows) {
+            const len = formatValue(row[col]).length;
+            if (len > widths[col])
+                widths[col] = len;
+        }
+    }
+    const lines = rows.map((row) => cols.map((c) => formatValue(row[c]).padEnd(widths[c])).join('  '));
+    if (noHeader) {
+        return lines.join('\n');
+    }
+    const header = cols.map((c) => c.toUpperCase().padEnd(widths[c])).join('  ');
+    const separator = cols.map((c) => '-'.repeat(widths[c])).join('  ');
+    return [header, separator, ...lines].join('\n');
+}
+function formatOutput(data, options) {
+    const { format, columns, idField = 'id', noHeader } = options;
+    switch (format) {
+        case 'json':
+            return JSON.stringify(data, null, 2);
+        case 'id-only': {
+            if (Array.isArray(data)) {
+                return data
+                    .map((item) => {
+                    const val = item[idField];
+                    return val !== null && val !== undefined ? `${val}` : '';
+                })
+                    .join('\n');
+            }
+            if (typeof data === 'object' && data !== null && idField in data) {
+                return String(data[idField]);
+            }
+            return '';
+        }
+        case 'table':
+        default: {
+            if (Array.isArray(data)) {
+                return renderTable(data, columns, noHeader);
+            }
+            if (typeof data === 'object' && data !== null) {
+                const entries = Object.entries(data);
+                if (noHeader) {
+                    return entries.map(([, v]) => formatValue(v)).join('\n');
+                }
+                const maxKeyLen = Math.max(...entries.map(([k]) => k.length));
+                return entries.map(([k, v]) => `${k.padEnd(maxKeyLen)}  ${formatValue(v)}`).join('\n');
+            }
+            return String(data);
+        }
+    }
+}
+function parseJqPath(expr) {
+    const segments = [];
+    let i = 0;
+    if (expr[0] === '.')
+        i++;
+    while (i < expr.length) {
+        if (expr[i] === '[') {
+            i++;
+            if (expr[i] === ']') {
+                segments.push({ type: 'iterate' });
+                i++;
+            }
+            else {
+                let numStr = '';
+                while (i < expr.length && expr[i] !== ']') {
+                    numStr += expr[i];
+                    i++;
+                }
+                segments.push({ type: 'index', index: parseInt(numStr, 10) });
+                i++;
+            }
+        }
+        else if (expr[i] === '.') {
+            i++;
+        }
+        else {
+            let name = '';
+            while (i < expr.length && expr[i] !== '.' && expr[i] !== '[') {
+                name += expr[i];
+                i++;
+            }
+            if (name) {
+                segments.push({ type: 'field', name });
+            }
+        }
+    }
+    return segments;
+}
+function evaluateJq(data, segments, startIdx) {
+    let current = data;
+    for (let i = startIdx; i < segments.length; i++) {
+        const seg = segments[i];
+        if (current === null || current === undefined)
+            return current;
+        switch (seg.type) {
+            case 'field':
+                if (typeof current === 'object' && current !== null) {
+                    current = current[seg.name];
+                }
+                else {
+                    return undefined;
+                }
+                break;
+            case 'index':
+                if (Array.isArray(current)) {
+                    current = current[seg.index];
+                }
+                else {
+                    return undefined;
+                }
+                break;
+            case 'iterate':
+                if (Array.isArray(current)) {
+                    return current.map((item) => evaluateJq(item, segments, i + 1));
+                }
+                return undefined;
+        }
+    }
+    return current;
+}
+function applyJqFilter(data, expression) {
+    const expr = expression.trim();
+    if (expr === '.')
+        return data;
+    const segments = parseJqPath(expr);
+    return evaluateJq(data, segments, 0);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@n8n/cli",
+  "version": "0.1.0",
+  "description": "Client CLI for n8n — manage workflows, executions, and credentials from the terminal",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "bin": {
+    "n8n-cli": "bin/n8n-cli.mjs"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "bin",
+    "dist",
+    "skills"
+  ],
+  "oclif": {
+    "bin": "n8n-cli",
+    "commands": {
+      "strategy": "explicit",
+      "target": "./dist/index.js",
+      "identifier": "commands"
+    },
+    "topicSeparator": " "
+  },
+  "dependencies": {
+    "@oclif/core": "^4.5.2"
+  },
+  "devDependencies": {
+    "@types/node": "25.5.0",
+    "vitest": "^3.1.3",
+    "@n8n/typescript-config": "1.3.0"
+  },
+  "scripts": {
+    "clean": "rimraf dist .turbo",
+    "dev": "pnpm watch",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "format": "biome format --write .",
+    "format:check": "biome ci .",
+    "lint": "eslint src --quiet",
+    "lint:fix": "eslint src --fix",
+    "watch": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run"
+  }
+}

package/skills/n8n-cli/SKILL.md

@@ -0,0 +1,268 @@
+---
+name: n8n-cli
+description: Use the n8n CLI to manage workflows, credentials, executions, and more on an n8n instance. Use when the user asks to interact with n8n, automate workflows, manage credentials, or operate their instance from the command line.
+allowed-tools: Bash(n8n-cli:*), Bash(echo:*), Bash(cat:*), Read, Write
+---
+
+# n8n CLI
+
+The `n8n-cli` command-line tool manages an n8n instance via its REST API.
+It auto-detects piped output and switches to JSON, making it composable for scripts and LLM tool use.
+
+## Setup
+
+```bash
+# Interactive login (saves to ~/.n8n-cli/config.json)
+n8n-cli login
+
+# Or configure directly
+n8n-cli config set-url https://my-instance.n8n.cloud
+n8n-cli config set-api-key n8n_api_...
+
+# Or use environment variables (no config file needed)
+export N8N_URL=https://my-instance.n8n.cloud
+export N8N_API_KEY=n8n_api_...
+```
+
+## Global Flags
+
+Every command supports these flags:
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--url` | `-u` | Instance URL (overrides config/env) |
+| `--apiKey` | `-k` | API key (overrides config/env) |
+| `--format` | `-f` | Output format: `table`, `json`, `id-only` |
+| `--json` | | Shorthand for `--format=json` |
+| `--jq` | | jq-style filter (implies `--json`), e.g. `'.[0].id'`, `'.[].name'` |
+| `--quiet` | `-q` | Suppress output |
+| `--no-header` | | Hide table headers (for `awk`/`cut` parsing) |
+| `--debug` | | Print HTTP details to stderr |
+
+**Auto-JSON:** When stdout is piped (not a TTY), output defaults to JSON automatically.
+
+## Workflows
+
+```bash
+# List all workflows
+n8n-cli workflow list
+
+# Filter workflows
+n8n-cli workflow list --active
+n8n-cli workflow list --tag=production
+n8n-cli workflow list --name="My Workflow"
+n8n-cli workflow list --limit=5
+
+# Get a single workflow (full JSON with nodes and connections)
+n8n-cli workflow get <id>
+
+# Extract just node names from a workflow
+n8n-cli workflow get <id> --jq '.nodes[].name'
+
+# Create a workflow from JSON
+n8n-cli workflow create --file=workflow.json
+cat workflow.json | n8n-cli workflow create --stdin
+
+# Update a workflow
+n8n-cli workflow update <id> --file=updated.json
+cat updated.json | n8n-cli workflow update <id> --stdin
+
+# Activate / deactivate
+n8n-cli workflow activate <id>
+n8n-cli workflow deactivate <id>
+
+# Delete a workflow
+n8n-cli workflow delete <id>
+
+# Transfer to another project
+n8n-cli workflow transfer <id> --project=<projectId>
+
+# List tags on a workflow
+n8n-cli workflow tags <id>
+```
+
+## Executions
+
+```bash
+# List recent executions
+n8n-cli execution list
+n8n-cli execution list --workflow=<id> --status=error --limit=10
+# status options: canceled, error, running, success, waiting
+
+# Get execution details
+n8n-cli execution get <id>
+n8n-cli execution get <id> --include-data   # includes full node I/O
+
+# Retry a failed execution
+n8n-cli execution retry <id>
+
+# Stop a running execution
+n8n-cli execution stop <id>
+
+# Delete an execution
+n8n-cli execution delete <id>
+```
+
+## Credentials
+
+```bash
+# List credentials
+n8n-cli credential list
+
+# Get credential metadata (not secrets)
+n8n-cli credential get <id>
+
+# Get the schema for a credential type (shows required fields)
+n8n-cli credential schema notionApi
+n8n-cli credential schema slackOAuth2Api
+
+# Create a credential
+n8n-cli credential create --type=notionApi --name='My Notion' --data='{"apiKey":"..."}'
+n8n-cli credential create --type=notionApi --name='My Notion' --file=cred.json
+cat cred.json | n8n-cli credential create --type=notionApi --name='My Notion' --stdin
+
+# Delete / transfer
+n8n-cli credential delete <id>
+n8n-cli credential transfer <id> --project=<projectId>
+```
+
+**Tip:** Use `credential schema <type>` to discover required fields before creating.
+
+## Projects
+
+```bash
+n8n-cli project list
+n8n-cli project get <id>
+n8n-cli project create --name="My Project"
+n8n-cli project update <id> --name="New Name"
+n8n-cli project delete <id>
+
+# Team management
+n8n-cli project members <id>
+n8n-cli project add-member <id> --user=<userId> --role=<role>
+n8n-cli project remove-member <id> --user=<userId>
+```
+
+## Tags
+
+```bash
+n8n-cli tag list
+n8n-cli tag create --name=production
+n8n-cli tag update <id> --name=staging
+n8n-cli tag delete <id>
+```
+
+## Variables
+
+```bash
+n8n-cli variable list
+n8n-cli variable create --key=API_ENDPOINT --value=https://api.example.com
+n8n-cli variable update <id> --key=API_ENDPOINT --value=https://new-api.example.com
+n8n-cli variable delete <id>
+```
+
+## Data Tables
+
+```bash
+# CRUD
+n8n-cli data-table list
+n8n-cli data-table get <id>
+n8n-cli data-table create --name=Inventory --columns='[{"name":"item","type":"string"},{"name":"qty","type":"number"}]'
+n8n-cli data-table delete <id>
+
+# Row operations
+n8n-cli data-table rows <id>
+n8n-cli data-table add-rows <id> --file=rows.json
+n8n-cli data-table update-rows <id> --file=rows.json
+n8n-cli data-table upsert-rows <id> --file=rows.json
+n8n-cli data-table delete-rows <id> --ids=row1,row2,row3
+
+# All row commands support --stdin
+cat rows.json | n8n-cli data-table add-rows <id> --stdin
+```
+
+## Users
+
+```bash
+n8n-cli user list
+n8n-cli user get <id>
+```
+
+## Other
+
+```bash
+# Security audit
+n8n-cli audit
+n8n-cli audit --categories=credentials,nodes
+
+# Source control
+n8n-cli source-control pull
+
+# View config
+n8n-cli config show
+```
+
+## Composability Patterns
+
+The CLI is designed to be piped and composed:
+
+```bash
+# Get all workflow IDs
+n8n-cli workflow list --jq '.[].id'
+
+# Get the name of the first workflow
+n8n-cli workflow list --jq '.[0].name'
+
+# Export a workflow to a file
+n8n-cli workflow get 1234 --json > workflow-backup.json
+
+# Find failing executions for a workflow
+n8n-cli execution list --workflow=1234 --status=error --json
+
+# Pipe workflow JSON for modification
+n8n-cli workflow get 1234 --json | jq '.name = "Updated Name"' | n8n-cli workflow update 1234 --stdin
+
+# Table output without headers for shell parsing
+n8n-cli workflow list --no-header | awk '{print $1}'
+
+# Debug API calls
+n8n-cli workflow list --debug 2>debug.log
+```
+
+## Workflow JSON Structure
+
+When creating or updating workflows, the JSON follows this structure:
+
+```json
+{
+  "name": "My Workflow",
+  "nodes": [
+    {
+      "name": "Start",
+      "type": "n8n-nodes-base.manualTrigger",
+      "position": [250, 300],
+      "parameters": {}
+    },
+    {
+      "name": "HTTP Request",
+      "type": "n8n-nodes-base.httpRequest",
+      "position": [450, 300],
+      "parameters": {
+        "url": "https://api.example.com/data",
+        "method": "GET"
+      }
+    }
+  ],
+  "connections": {
+    "Start": {
+      "main": [[{ "node": "HTTP Request", "type": "main", "index": 0 }]]
+    }
+  }
+}
+```
+
+Key points:
+- `nodes[].type` follows the pattern `n8n-nodes-base.<nodeName>` for built-in nodes
+- `connections` is keyed by source node name, with `main` output arrays
+- Each connection specifies target `node`, `type` (usually `main`), and output `index`
+- Use `workflow get <id> --json` to see real examples from the instance