Skip to content

n8n-as-code v2.1.0

Choose a tag to compare

@github-actions github-actions released this 11 May 13:31
· 241 commits to main since this release

n8n-as-code 2.1.0

Product Surface

  • Editor integrations published via Microsoft Marketplace and Open VSX
  • Shared n8nac CLI for workspace bootstrap, sync, and automation
  • AI Skills and Claude-ready agent context generation
  • MCP server for Model Context Protocol clients
  • OpenClaw plugin support
  • TypeScript transformer for n8n workflow code

Included in this release

  • Manager Adapter: 2.0.3 -> 2.0.3
  • AI Skills and Claude Integration: 2.1.0 -> 2.1.0
  • CLI: 2.1.0 -> 2.1.0
  • MCP Server: 2.0.4 -> 2.0.4
  • Editor Integrations: 2.2.0 -> 2.2.0
  • OpenClaw Plugin: 2.1.0 -> 2.1.0

Manager Adapter

Package: @n8n-as-code/manager-adapter@2.0.3

Facade adapter from n8n-as-code surfaces to the independent n8n-manager runtime engine.

Bug Fixes

  • manager-adapter: prevent workspace root override for explicit instance opens (f48646a)
  • cli: exclude already migrated v4 environments from migration detection (0e0ac13)

AI Skills and Claude Integration

Package: @n8n-as-code/skills@2.1.0

Embedded n8n ontology, AGENTS.md generation, and Claude-oriented workflow tooling.

Features

  • cli: add workflow present command and update agent skill guidance (70d4425)
  • cli: add workspace migration command and improve migration orchestration (603aa59)

Bug Fixes

  • cli: unify workspace migration reporting and enforce atomicity (0e3e07f)
  • cli: enforce migration-first workflow for workspace readiness (cc11e37)
  • skills: consolidate agent skills into n8n-architect (6212c2f)
  • cli: add v1 migration path (ff0c979)
  • skills: rebuild knowledge base for n8n@2.19.5 (ce71618)
  • skills: rebuild knowledge base for n8n@2.19.4 (2b2d238)

Documentation

  • update documentation for unified workspace migration and readiness (e078a79)
  • skills: update n8n-architect guidance for unified migration and env status (1be0695)
  • add command glossary and update skill dependencies (142b253)
  • align docs and skills with environments (267e9c2)
  • update documentation for v2 split runtime and workspace model (b8a4125)
  • skills: update installation instructions for generic agents (fb9b903)

CLI

Package: n8nac@2.1.0

Shared command-line backbone for workspace bootstrap, GitOps sync, search, and automation.

Features

  • cli: improve environment authentication and sync folder management (a891dfb)
  • cli: implement intelligent workflow URL resolution (98f55fb)
  • vscode: implement workspace migration facade and runner (94f695e)
  • cli: add workflow present command and update agent skill guidance (70d4425)
  • cli: add workspace migration command and improve migration orchestration (603aa59)
  • ui: implement migration for global n8n instances to workspace (a8d6026)
  • cli,vscode: implement environment-centric configuration and legacy migration (92f6c34)
  • cli: add interfaces for legacy workspace upgrade orchestration (2d87d80)
  • wire workspace environments into cli and vscode (e9f1066)
  • cli: add workspace environment config model (d7be153)

Bug Fixes

  • cli: prioritize baseUrl over tunnelPublicUrl for instance resolution (aee2f0a)
  • cli: exclude already migrated v4 environments from migration detection (0e0ac13)
  • cli: update workflow presentation access logic (96c98a1)
  • cli: unify workspace migration reporting and enforce atomicity (0e3e07f)
  • cli: enforce migration-first workflow for workspace readiness (cc11e37)
  • skills: consolidate agent skills into n8n-architect (6212c2f)
  • config: use helper method for external instance URL resolution (4965535)
  • config: rename instance targets to environment targets and update terminology (c33d024)
  • config: refine migration logic and improve credential retrieval (389a2a9)
  • cli,vscode: transition from instance-based to environment-centric configuration (788c956)
  • cli: harden environment promotion safety (09543c0)
  • cli: harden workspace environment config resolution (bcdf543)
  • close workspace environment review gaps (c01cf7c)
  • cli: preserve idless legacy instances (1081b94)
  • cli: harden v1 migration edge cases (789d833)
  • cli: add v1 migration path (ff0c979)

Documentation

  • update documentation for unified workspace migration and readiness (e078a79)
  • align docs and skills with environments (267e9c2)
  • update documentation for v2 split runtime and workspace model (b8a4125)

Dependencies

  • The following workspace dependencies were updated
    • @n8n-as-code/manager-adapter bumped from 2.0.2 to 2.0.3
    • @n8n-as-code/skills bumped from 2.0.1 to 2.1.0

MCP Server

Package: @n8n-as-code/mcp@2.0.4

Dedicated Model Context Protocol server exposing n8n-as-code tools to MCP clients.

Dependencies

  • The following workspace dependencies were updated
    • n8nac bumped from 2.0.3 to 2.1.0

Editor Integrations

Package: n8n-as-code@2.2.0

Marketplace and Open VSX editor integration for browsing, searching, syncing, and validating n8n workflows.

Features

  • vscode: implement automated AI context freshness management (5aa9e98)
  • ui: add managed instance status warnings to configuration webview (ab34ca8)
  • vscode: implement workspace migration facade and runner (94f695e)
  • cli: add workspace migration command and improve migration orchestration (603aa59)
  • ui: implement migration for global n8n instances to workspace (a8d6026)
  • ui: update configuration webview to support environment-specific project loading (009e75e)
  • cli,vscode: implement environment-centric configuration and legacy migration (92f6c34)
  • wire workspace environments into cli and vscode (e9f1066)

Bug Fixes

  • cli: prioritize baseUrl over tunnelPublicUrl for instance resolution (aee2f0a)
  • config: rename instance targets to environment targets and update terminology (c33d024)
  • ui: decouple instance lookups from workspace root (92219a6)
  • config: refine migration logic and improve credential retrieval (389a2a9)
  • cli,vscode: transition from instance-based to environment-centric configuration (788c956)
  • vscode: align workspace environments with v4 targeting (96d31c5)
  • close workspace environment review gaps (c01cf7c)
  • cli: add v1 migration path (ff0c979)

Documentation

  • update documentation for unified workspace migration and readiness (e078a79)
  • align docs and skills with environments (267e9c2)
  • clarify v1 legacy extension install (49ad824)
  • update documentation for v2 split runtime and workspace model (b8a4125)

Dependencies

  • The following workspace dependencies were updated
    • @n8n-as-code/manager-adapter bumped from 2.0.2 to 2.0.3
    • @n8n-as-code/skills bumped from 2.0.1 to 2.1.0
    • n8nac bumped from 2.0.3 to 2.1.0

OpenClaw Plugin

Package: @n8n-as-code/n8nac@2.1.0

Native OpenClaw setup and workflow operations powered by the same n8nac stack.

Features

  • cli: add workflow present command and update agent skill guidance (70d4425)
  • cli: add workspace migration command and improve migration orchestration (603aa59)

Bug Fixes

  • cli: unify workspace migration reporting and enforce atomicity (0e3e07f)
  • cli: enforce migration-first workflow for workspace readiness (cc11e37)
  • skills: consolidate agent skills into n8n-architect (6212c2f)

Documentation

  • update documentation for unified workspace migration and readiness (e078a79)
  • skills: update n8n-architect guidance for unified migration and env status (1be0695)
  • align docs and skills with environments (267e9c2)
  • update documentation for v2 split runtime and workspace model (b8a4125)