From n8n-autopilot
Curated mapping of user intents to exact n8nac CLI commands for 60+ workflows. Use this before the reference or --help.
How this skill is triggered — by the user, by Claude, or both
Slash command
/n8n-autopilot:n8nac-cheatsheetThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Source-of-truth for "what command do I run for X?"** If your task matches a row, run the exact command shown — do not paraphrase, do not invent flags, do not run `--help`. If no row matches, fall back to `n8nac-reference` for the full help tree.
Source-of-truth for "what command do I run for X?" If your task matches a row, run the exact command shown — do not paraphrase, do not invent flags, do not run --help. If no row matches, fall back to n8nac-reference for the full help tree.
All commands below assume
npx n8nac …and a workspace bound to an n8n instance (workspace status: bound). Replace<id>,<name>,<path>with concrete values.
| User intent | Command |
|---|---|
| First-time setup (connect to existing n8n) | npx n8nac env add <name> --base-url "$N8N_API_URL" --workflows-path workflows then printf "%s" "$N8N_API_KEY" | npx n8nac env auth set <name> --api-key-stdin then npx n8nac env use <name> |
| List supported setup modes | npx n8nac setup-modes |
| Show effective workspace context (active project, instance, sync folder) | npx n8nac workspace status --json |
| Bind instance + set sync folder (new env) | npx n8nac env add <name> --base-url <url> --workflows-path workflows |
| Switch active project on an environment | npx n8nac env update <env> --project-name "<name>" or --project-id "<id>" |
| Set workflow sync folder on an existing env | npx n8nac env update <env> --workflows-path <relativePath> |
| User intent | Command |
|---|---|
| List configured environments | npx n8nac env list --json |
| Show active environment + auth state | npx n8nac env status --json |
| Add a new environment | npx n8nac env add <name> --base-url <url> --workflows-path workflows |
| Switch active environment | npx n8nac env use <name> (alias: env pin) |
| Store API key for an environment | printf "%s" "$N8N_API_KEY" | npx n8nac env auth set <name> --api-key-stdin |
| Update any env property (URL / project / sync folder / name) | npx n8nac env update <name-or-id> --base-url <url> (swap flag as needed) |
| Target one command at a non-active env | npx n8nac --env <name> <command> (root flag) |
| User intent | Command |
|---|---|
| List all workflows (local + remote, excluding archived) | npx n8nac list --json |
| List including archived | npx n8nac list --include-archived --json |
| List archived only | npx n8nac list --only-archived --json |
| Filter by search term | npx n8nac list --search "<query>" --json |
| Search by partial name / ID / filename | npx n8nac find "<query>" --json |
| Search remote only | npx n8nac find "<query>" --json --remote |
| Download a single workflow from n8n | npx n8nac pull <workflowId> |
| Refresh internal cache for one workflow (no file write) | npx n8nac fetch <workflowId> |
| Upload a single workflow | npx n8nac push <path> |
| Upload + verify remote after push (preferred) | npx n8nac push <path> --verify |
| Validate remote workflow against local schema | npx n8nac verify <workflowId> |
| Resolve a local/remote conflict — remote wins | npx n8nac pull <workflowId> |
| Resolve a conflict — local wins (BLOCKED by push-gate) | N8N_AUTOPILOT_ALLOW_LOCAL_WINS=1 npx n8nac resolve <id> --mode keep-current |
| Resolve interactively | npx n8nac resolve <id> |
| Activate a workflow on the remote | npx n8nac workflow activate <id> |
| Deactivate a workflow | npx n8nac workflow deactivate <id> |
| Resolve the canonical UI URL | npx n8nac workflow present <id> --json |
| Check whether all credentials are present for a workflow | npx n8nac workflow credential-required <id> (exit 0 = OK, exit 1 = missing) |
| Promote a workflow from env A to env B | npx n8nac promote <path> --from <envA> --to <envB> |
| Convert local file JSON ↔ TypeScript | npx n8nac convert <file> |
| Batch convert a directory | npx n8nac convert-batch <directory> |
| Regenerate AGENTS.md + AI context | npx n8nac update-ai |
| User intent | Command |
|---|---|
| Infer trigger type + payload before testing | npx n8nac test-plan <id> --json |
| Test webhook/chat/form (POST body) | npx n8nac test <id> --data '<json>' |
| Test webhook (GET query string) | npx n8nac test <id> --query '<json>' |
| Test against production URL (workflow must be active) | npx n8nac test <id> --prod --data '<json>' |
| List recent executions for a workflow | npx n8nac execution list --workflow <id> --limit 10 |
| Get one execution's full I/O | npx n8nac execution get <executionId> --include-data |
| Get one execution's metadata only | npx n8nac execution get <executionId> |
| User intent | Command |
|---|---|
| List all credentials (metadata, no secrets) | npx n8nac credential list --json |
| Get one credential's metadata | npx n8nac credential get <id> |
| Show JSON schema for a credential type | npx n8nac credential schema <type> |
| Create a credential | npx n8nac credential create --type <type> --name "<name>" --file cred.json |
| Delete a credential | npx n8nac credential delete <id> |
For project-aware credential lookup, use
/n8n-autopilot:find-credential(default = active project, no cross-project leak). Usecredential listdirectly only when you need raw shape.
| User intent | Command |
|---|---|
| List available credential recipes (openai-native, slack-oauth, postgres, …) | npx n8nac credentials recipes --json |
| List the local credential inventory (which recipes are satisfied?) | npx n8nac credentials inventory --json |
| Create a credential from a recipe | npx n8nac credentials ensure <recipeId> |
| Test that a credential works against the live service | npx n8nac credentials test <id-or-recipeId> |
| List bundled starter-kits | npx n8nac credentials starter-kits |
| Apply a starter-kit | npx n8nac credentials starter-kit <kitId> |
| Delete a credential via the recipe surface | npx n8nac credentials delete <id> |
| User intent | Command |
|---|---|
| Search nodes by service / keyword | npx n8nac skills search "<query>" --json |
| Get exact TypeScript snippet for one node | npx n8nac skills node-schema <type> --json |
| Get full node info (params, credentials, typeVersion) | npx n8nac skills node-info <type> --json |
| Find related/alternative nodes | npx n8nac skills related "<query>" --json |
| Search community workflow examples (7000+ templates) | npx n8nac skills examples search "<query>" --json |
| Get details for one example | npx n8nac skills examples info <id> |
| Download an example as starting point | npx n8nac skills examples download <id> |
| Search docs / guides | npx n8nac skills docs "<query>" / npx n8nac skills guides "<query>" |
Validate a .workflow.ts locally | npx n8nac skills validate <path> --strict --json |
| Refresh AI context (AGENTS.md etc.) via skills facade | npx n8nac skills update-ai |
| Launch n8nac's bundled MCP server (experimental) | npx n8nac skills mcp |
| User intent | Command |
|---|---|
| Enable / disable / status anonymous telemetry | npx n8nac telemetry --help (small surface — read directly) |
credential / credentials — different parent groups. credential for raw CRUD on the active instance; credentials for recipes, inventory, starter-kits, and ensure/test against a recipe ID.workspace status --json returns two shapes: bound (has activeEnvironment block) or pending (has status: "dry-run"|"migration-required"). Probe j.activeEnvironment first.credential list --json returns every credential the API key can see across ALL projects. Each cred carries shared[] with project ownership; use /n8n-autopilot:find-credential for project-scoped lookup instead of grep-piping.push blocked when status is CONFLICT / MODIFIED_BOTH / DIVERGED / REMOTE_ONLY — see CLAUDE.md "Push-Gate" section. Bypass: N8N_AUTOPILOT_ALLOW_LOCAL_WINS=1.resolve --mode keep-current is unconditionally blocked by the push-gate. Same bypass as above.n8nac test cannot trigger schedule/manual/errorTrigger — only webhook/chat/form. For other triggers, prompt the user to "Execute Workflow" in the n8n UI (see build-workflow Path B).mcpTrigger workflows require manual UI publish after every push. n8nac push writes a new draft; the previously-published MCP endpoint may diverge.push will reject. Unarchive in n8n UI first (no n8nac command for this)./api/v1/data-tables is the only n8n public API path you may hit directly (see /n8n-autopilot:data-tables). Everything else goes through n8nac.init, init-auth, init-project no longer exist — use setup --mode <mode>. Post-setup binding is via env add / env auth set / env use (NOT workspace pin-instance, which is also removed). workspace set-project, workspace set-sync-folder, workspace clear-*, workspace migrate, workspace migrate-v1, and instance-target are all gone — use env update <name> --project-name/--workflows-path instead.Read n8nac-reference/reference.md — the full machine-generated help tree (61 command/subcommand blocks).
npx claudepluginhub neurawork-git/n8n-autopilot --plugin n8n-autopilotAuthoritative reference for every n8nac CLI command, subcommand, and flag (n8nac 2.3.6). Use this to look up exact flags, argument orders, and confirm existence before running --help.
Creates, edits n8n workflows as TypeScript files with node docs access and n8nac CLI for workspace init, preventing param errors.
Routes to relevant n8n skills, summarizes n8n MCP tools, and enforces cross-cutting rules for workflow creation. Always active for n8n work.