Skip to main content

Welcome to n8n-as-code

n8n-as-code lets you manage your n8n workflows like real code: edit them locally, version them with Git, sync them explicitly, and let AI agents build or fix them for you.

How It Works​

  1. Connect to your n8n instance (cloud or self-hosted)
  2. Pull workflows to your local workspace
  3. Edit them in VS Code, or let an AI agent do the work
  4. Push your changes back to n8n when you're ready
  5. Version everything with Git for history, review, and collaboration

No surprise auto-sync. You control when changes move.

Choose Your Entry Point​

If you use…Start here
VS Code / CursorVS Code Extension — visual editing, status tree, push/pull from the sidebar
Claude Code / Claude DesktopClaude Plugin — ask Claude to create, edit, or fix workflows for you
OpenClawOpenClaw Plugin — same AI workflow experience inside OpenClaw
Terminal / CICLI — automation, scripting, and CI/CD pipelines

Or jump straight to the Getting Started guide for step-by-step setup.

Key Features​

  • Git-like sync — explicit list, pull, push, resolve commands. You decide when to sync.
  • 3-way conflict detection — only flags real conflicts (both sides changed). No false positives.
  • TypeScript workflows — optional decorator-based format for better readability and AI compatibility. Learn more →
  • AI-powered workflow creation — Claude, Cursor, and other AI agents can create, update, and fix workflows using built-in n8n knowledge (500+ node schemas, documentation, community examples).
  • VS Code integration — tree view with status indicators, split view with n8n canvas, push/pull from context menu.
  • Multi-instance support — work with multiple n8n environments, files organized by instance automatically.

Quick Start​

# Install
npm install -g n8nac

# Connect to your n8n instance and select a project
n8nac init

# See all workflows and their sync status
n8nac list

# Pull a workflow to edit locally
n8nac pull <workflowId>

# Push your changes back
n8nac push workflows/instance/project/my-workflow.workflow.ts

Or install the VS Code extension and do everything from the sidebar. See Getting Started for the full walkthrough.

Documentation​

Get Involved​

n8n-as-code is open source (Apache-2.0).