If you love n8n for automation but feel like you could be moving faster, this tutorial is for you.
We all know the scenario: n8n is incredible. But sometimes, building complex logic with a mouse takes time. You find yourself thinking: "If only I could copy-paste this workflow like code..."
Good news: Now you can.
By connecting n8n to your code editor (VS Code), you shift paradigms. You are no longer limited by the graphical interface. You unlock a superpower:
- Open VS Code (or an AI editor like Cursor).
- Ask an AI Agent: "Create a workflow that scrapes Google News every morning and sends it to Slack".
- The AI writes the JSON code.
- Boom. The workflow appears instantly in your n8n interface, ready to run.
No need to be a DevOps expert. Let's set up this "magic bridge" in 2 minutes using a ready-made open-source tool.
π How does it work?
The idea is simple. Instead of viewing your workflows as graphical boxes, we treat them as source files.
We use a tool called n8n-as-code\ that acts as a transparent intermediary:
- π It watches what you (or the AI) write on your computer.
- π It pushes everything to n8n instantly.
- π‘ It sanitizes the code automatically to prevent bugs and keep your Git history clean.
(Caption: Your new workspace: Code on the left, n8n Execution on the right)
β‘οΈ Quick Start (2 minutes)
You need Node.js installed and an active n8n instance (local or cloud).
Step 1: Clone and Link
Don't reinvent the wheel. Clone the repo and install the CLI globally:
\bash
git clone https://github.com/EtienneLescot/n8n-as-code.git
cd n8n-as-code
npm install && npm run build
npm link
\\
Note:
npm link\allows you to run then8n-as-code\command from anywhere in your terminal.
Step 2: Configuration
Forget manual configuration files. Run the interactive setup wizard:
\bash
n8n-as-code init
\\
The wizard will ask for your n8n URL and API Key.
Security Note: Your API key is stored securely on your machine (Global Storage) and is never saved inside your project folder. This keeps your Git history clean and safe.
Step 3: Launch
First, download your existing workflows:
\bash
n8n-as-code pull
\\
Then, start the sync engine in real-time mode:
\bash
n8n-as-code watch
\\
You are ready!
π Demo: Let the AI Work
Here is where the magic happens. Now that n8n-as-code watch\ is running:
- Open the folder in VS Code. You will see your existing workflows.
- Option A (Edit): Open an existing file, change a node parameter (e.g. rename a node), and Save. Watch n8n update instantly.
-
Option B (Create): Create a new file
My_New_Bot.json\. Ask your AI: > "Generate the JSON for an n8n workflow. It should run every day at 9 AM, fetch a joke from a public API, and send it to a Slack channel." - Save (
CTRL + S\). - Boom. The workflow is created in n8n!
π‘ Why You'll Love It
- 10x Speed: AI is much faster at writing JSON boilerplate than you are at dragging and dropping 10 nodes.
- GitOps: Your workflows are now clean files. You can finally commit them to GitHub and work in teams.
- Reliability: The tool handles the bidirectional sync and cleanup for you, so you don't break your workflows.
Ready to try?
Get the open-source code here: github.com/EtienneLescot/n8n-as-code
Happy coding! π
Top comments (1)
And if you want to discover the VSCode extension :
dev.to/etienne_lescot_728112921e/u...