Skip to content

n8n-as-code v2.0.0

Choose a tag to compare

View all tags
@EtienneLescot EtienneLescot released this 06 May 11:26
· 300 commits to next since this release
v2.0.0
93023fe

Highlights

n8n-as-code v2 turns the project into a context-aware workflow engineering environment for n8n.

The release introduces two major pieces:

  • A built-in n8n-as-code Agent in the VS Code extension.
  • n8n-manager as the shared runtime layer for instances, environments, credentials, projects, and workspace bindings.

Together they move n8n-as-code from workflow sync tooling toward an agent-assisted development environment that can create, inspect, improve, test, and deploy workflows with real workspace context.

n8n-as-code Agent

The VS Code extension now includes an integrated agent built specifically for n8n workflow engineering.

Unlike prompt-only workflow builders, the agent works with live development context. It can use the current workflow, selected node, workspace configuration, active instance, project state, and local n8n-as-code metadata to reason about what it should do.

You can use it to:

  • Create new workflows from intent.
  • Explain a selected node or workflow branch.
  • Improve an existing workflow structure.
  • Add retry, error-handling, or branching logic.
  • Refactor workflow code and node configuration.
  • Run or prepare workflow tests with the right context.
  • Work against local, staging, or production n8n environments.

This is the main direction of v2: an agent with n8n superpowers, embedded where workflow code and runtime context already live.

n8n-manager

v2 also introduces n8n-manager as the runtime foundation for n8n-as-code.

It provides a single place to manage the n8n environments that agents, the CLI, and the VS Code extension operate against.

n8n-manager can:

  • Create and manage n8n instances.
  • Connect local, staging, and production environments.
  • Bind instances and projects to a workspace.
  • Manage runtime state, tunnels, API access, and credentials.
  • Let a workspace go from zero setup to a live n8n target faster.

This replaces the older model where different surfaces owned parts of instance configuration independently.

Unified v2 Runtime Model

n8n-as-code v2 aligns the CLI, VS Code extension, OpenClaw plugin, Claude/Cursor skills, MCP server, and generated agent context around one shared model:

  • n8n-manager owns runtime setup and instance state.
  • n8nac owns workspace and workflow operations.
  • Editor and agent integrations consume the same effective context.
  • Generated agent instructions point assistants to the same commands and boundaries.

The result is a more predictable workflow across terminal, editor, plugins, and AI agents.

What Is New

  • Integrated n8n-as-code Agent inside the VS Code extension.
  • Shared runtime management through n8n-manager.
  • Workspace-aware agent context for workflows, selected nodes, instances, projects, and sync folders.
  • Cleaner separation between runtime management and workflow authoring.
  • Updated VS Code configuration and agent workbench flows.
  • Updated Claude, Cursor, and OpenClaw skills for the new runtime model.
  • Updated CLI and MCP packages to use the v2 context model.
  • Refreshed knowledge base and generated n8n metadata.

Breaking Changes

This is a major release.

  • Runtime state is now resolved through n8n-manager.
  • Workspace-local instance libraries are no longer the source of truth for runtime state.
  • Legacy n8nac init, n8nac switch, and local instance-management flows have been removed or replaced.
  • Agent and plugin workflows now expect n8n-manager for runtime setup/state and n8nac for workspace/workflow operations.
  • VS Code runtime behavior now follows global manager context plus explicit workspace overrides.

Upgrade Notes

  • Upgrade the CLI, VS Code extension, skills, MCP server, and plugins together when possible.
  • Configure runtime state through n8n-manager.
  • Use n8nac for workspace and workflow operations.
  • Regenerate agent context after upgrading with n8nac update-ai.
  • Review automations that still call removed v1 commands such as n8nac init or n8nac switch.

Included Packages

This release aligns the n8n-as-code ecosystem on the v2 line:

  • n8nac CLI
  • n8n-as-code VS Code extension
  • @n8n-as-code/skills
  • @n8n-as-code/transformer
  • @n8n-as-code/mcp
  • @n8n-as-code/n8nac OpenClaw plugin

Validation

Validation from the release branch included:

  • npm test in n8n-manager: 38 passed, 0 failed.
  • npm test in n8n-as-code: transformer, skills, CLI, OpenClaw, VS Code unit tests, and CLI live integration tests.
  • Targeted checks for skills generation, CLI behavior, OpenClaw packaging, VS Code build output, and release packaging.
Assets 2
Loading