Skip to content

Latest commit

 

History

History

README.md

n8n-as-code logo n8n-as-code

The AI skill and editor integration that gives your coding agent n8n superpowers.

n8n-as-code turns compatible editors into a GitOps and AI workspace for n8n workflows: pull from n8n, edit locally, search nodes and templates instantly, validate before deploy, and push changes back with full control.

Published for both the Microsoft Marketplace and Open VSX.

n8n-as-code demo


⚡ Quick Start

  1. Install n8n-as-code from the Microsoft Marketplace or Open VSX.
  2. Open a folder or .code-workspace before initialization.
  3. Open the n8n view, run n8n: Configure, enter the URL and API key of the existing n8n instance you want to use, load the target project, then save and activate the config.
  4. Refresh the explorer to list your workflows and start syncing.

Marketplace links:


What You Get

GitOps for n8n

Use a deliberate pull, edit, validate, push workflow instead of editing directly in the browser. n8n-as-code keeps local files and the remote n8n instance aligned without hiding sync decisions from you.

Built-in AI Context

The editor integration is backed by the shared n8nac CLI and @n8n-as-code/skills package, so agents can work with the same embedded n8n ontology used across the broader project:

  • JSON schema validation for live feedback
  • snippets for common nodes and workflow patterns
  • AGENTS.md generation for Copilot, Cursor, Windsurf, Claude Code, and similar tools
  • local search across nodes, docs, and workflow templates

Workflow Search

Use Find Workflow from the n8n view or Command Palette to jump straight to a workflow by partial name, workflow ID, or local filename instead of scrolling long trees.

Conflict Protection

If a workflow diverges locally and remotely, synchronization pauses instead of guessing. You can inspect the diff and decide whether to keep the local or remote version.

Split View

Open a live split view to compare the code and the n8n canvas while you edit. This is useful for validating structural changes before you push.

Multi-Instance Workspace Layout

Workflows are grouped by instance and project so multiple environments can coexist cleanly in the same workspace.

Shared Product Surface

This editor distribution is one entry point into the wider n8n-as-code product surface:

  • editor integration via Microsoft Marketplace and Open VSX
  • n8nac CLI for direct terminal workflows
  • AI skills for coding agents
  • Claude Code and OpenClaw integrations in the monorepo

⚙️ Configuration

The extension stores saved instance configs and the active selection in n8nac-config.json at the workspace root. This lets one workspace keep multiple n8n environments without losing previously saved configs.

The legacy native editor settings below still exist as compatibility fallbacks:

Parameter Description Default
n8n.host URL of your n8n instance -
n8n.apiKey Your n8n API Key -
n8n.syncFolder Local storage folder workflows

In the configuration screen:

  • Add instance saves another existing n8n environment in the workspace
  • Select instance loads a saved config into the form
  • Save and activate config makes that config the active one for the workspace

Philosophy

n8n-as-code is not a browser companion. It is a local-first workflow environment for n8n.

  • your agent works from real local files
  • the n8n schema and docs are available offline in the installed assets
  • sync is explicit, reviewable, and Git-friendly

That is why the same project can power editor workflows, CLI automation, Claude integrations, and OpenClaw without changing the underlying mental model.


📄 License

MIT