GitOps · AI Skills · TypeScript Workflows · VS Code · Claude Code · OpenClaw
Your AI agent doesn't just read about n8n. It knows n8n.
An installable ontology for n8n — every node, every property, every option, and the relationships between them — embedded at install time.
Zero external calls. Zero latency. Zero hallucination.
⚠ n8n version compatibility — The node schema bundled with n8n-as-code is built against the latest stable release of n8n. For best results, keep your n8n instance up to date. Using an outdated instance may cause generated workflows to reference node type-versions not yet supported by your instance, which n8n renders as broken nodes in the canvas.
Choose the entry point that matches how you already work.
|
Yagr is the recommended way to get started. Best for: fastest setup, agent-first workflow, shared runtime across tools Run |
Yagr is still in beta. If you want the most proven setup today, choose one of the four options below.
|
Visual workflow view inside the editor. Best for: VS Code, Cursor, Windsurf, Antigravity Setup |
Plugin-driven workflow work with Claude. Best for: agent-led editing with marketplace install Run |
|
OpenClaw-native plugin and workspace bootstrap flow. Best for: OpenClaw users who want built-in grounding and setup Run |
Explicit terminal-first workflow for sync and automation. Best for: scripts, CI, GitOps pipelines, direct workflow operations Run . |
Then simply tell your agent what you want to do with your n8n workflows. Build new flows, update existing ones, search nodes and templates, validate changes, pull from n8n, push updates, and keep everything in sync.
If you are using Claude Desktop or another MCP client, point it at the local MCP server with:
{
"mcpServers": {
"n8n-as-code": {
"command": "npx",
"args": ["--yes", "n8nac", "skills", "mcp"]
}
}
}Initialize your workspace first so it has both the sync config and AI context it needs:
npx --yes n8nac init
npx --yes n8nac update-aiNot a bridge. Not a proxy. A Skill.
Pre-built knowledge that your AI agent carries with it — works in Cursor, Cline, Windsurf, Copilot, Claude, or any coding agent.
In 2026 AI tooling language, this layer is increasingly described as an ontology: a structured domain map that tells an agent what exists, how it fits together, and which actions are valid. That is exactly what n8n-as-code ships for n8n.
| 🧩 537 n8n nodes | 433 core + 104 AI/LangChain — every official node, nothing missing |
| 📋 100% schema coverage | 10,209 properties + 17,155 option values — the ontology stays grounded in the real schema |
| 📚 1,243 documentation pages | 93% of nodes have linked docs — integrations, triggers, AI, hosting, code |
| 🔄 7,702 workflow templates | Full community library — searchable in ~5ms with FlexSearch |
| 🤖 104 AI/LangChain nodes | Agents, chains, LLMs, tools, memory, vector stores, retrievers |
| 💡 170 pages with code examples | Ready-to-use snippets extracted from official n8n docs |
| ✅ Built-in validation | Schema validation catches errors before you push to production |
# Your agent can search nodes, docs, and templates instantly
npx --yes n8nac skills search "send slack message when google sheet is updated"
npx --yes n8nac skills node-info slack # Full schema + docs + examples
npx --yes n8nac skills examples search "AI agent" # Search 7,702 templates
npx --yes n8nac skills validate workflow.json # Validate before deployingClaude Code uses the same n8nac CLI and ships the n8n-architect skill through the n8n-as-code plugin, so natural-language workflow work and terminal automation stay aligned around the same n8n ontology.
n8n-as-code ships a searchable index of public community workflow metadata and downloads the workflow JSON on demand when an agent or user explicitly requests it.
The current community workflow catalog is built from nusquama/n8nworkflows.xyz. As in the upstream archive, each workflow keeps its original license and users should refer to the original workflow metadata and source page for license details. The repository structure and indexing logic in n8n-as-code remain licensed under the MIT License.
Thanks to the n8nworkflows.xyz project for maintaining the public archive that makes this search experience possible.
Manage your entire workflow lifecycle — pull, edit, push, resolve conflicts, version with Git.
pull
┌──────────┐ ◄──────────── ┌───────────┐
│ n8n │ │ Local │
│ Instance │ ──────────── ►│ Files │
└──────────┘ push └───────────┘
│
git commit
│
┌────▼────┐
│Git Repo │
└─────────┘
npx n8nac init # Connect your n8n instance
npx n8nac list # See sync status at a glance
npx n8nac pull <id> # Pull remote → local
npx n8nac push my-workflow.workflow.ts # Push local → remote
npx n8nac resolve <id> --mode keep-current # Explicit conflict resolution3-way merge conflict detection · Multi-instance support
Convert n8n JSON workflows to clean, type-safe TypeScript with decorators.
Bidirectional — convert back to JSON anytime.
import { workflow, node, links } from '@n8n-as-code/transformer';
@workflow({ id: 'abc123', name: 'Slack Notifier', active: true })
export class SlackNotifierWorkflow {
@node()
Trigger = {
type: 'n8n-nodes-base.webhook',
parameters: { path: '/notify', method: 'POST' },
position: [250, 300]
};
@node()
Slack = {
type: 'n8n-nodes-base.slack',
parameters: {
resource: 'message',
operation: 'post',
channel: '#alerts',
text: '={{ $json.message }}'
},
position: [450, 300]
};
@links([{ from: 'Trigger', to: 'Slack' }])
connections = {};
}n8nac convert workflow.json --format typescript # JSON → TypeScript
n8nac convert-batch workflows/ --format typescript # Bulk convert to TypeScript
n8nac pull <id> > workflow.json && n8nac convert workflow.json --format typescript # Pull then convert to TypeScriptWhy TypeScript? → Better diffs in Git · Better readability in editors · Much easier for AI to read & edit
Visual editing without leaving your IDE. A dedicated sidebar, embedded n8n canvas, and one-click sync.
- Install from VS Code Marketplace or OpenVSX Marketplace
- Click the n8n icon in the Activity Bar
- Configure your instance → Start editing
ℹ️ Workspace required: Open a folder or a
.code-workspacebefore running Initialize n8n as code.
The extension needs an active workspace to index files and settings.
What you get:
- 📂 Workflow sidebar — browse all local & remote workflows with sync status
- 🖼️ Embedded n8n canvas — visual split-view editing
- ☁️ One-click push/pull — sync workflows without touching the terminal
- ⚡ Push-on-save — auto-deploy when you save
- 🔀 Conflict resolution UI — visual merge conflicts
| Package | What it does | Install |
|---|---|---|
| n8nac | CLI — sync, convert, validate, search | npx n8nac |
| VS Code Extension | Visual UI — sidebar, canvas, push-on-save | Marketplace |
| @n8n-as-code/n8nac | OpenClaw plugin — setup wizard, prompt context, workflow operations | openclaw plugins install @n8n-as-code/n8nac |
| @n8n-as-code/skills | AI Skill — knowledge base, search, schemas | npm i @n8n-as-code/skills |
| @n8n-as-code/transformer | JSON ↔ TypeScript converter | npm i @n8n-as-code/transformer |
+------------------------------------------------------------------+
| User Interfaces |
| |
| [CLI] [VS Code] [Claude Code] [OpenClaw] |
| sync/search canvas/sidebar plugin workflow plugin workflow |
+-------------------+----------------------+-----------------------+
| |
v v
+-------------------+----------------------+-----------------------+
| Core Services |
| |
| [Sync Engine] [Transformer] |
| 3-way merge / conflicts JSON <-> TypeScript |
+-------------------------------+----------------------------------+
|
v
+------------------------------------------------------------------+
| AI Skills Layer |
| |
| 537 nodes / 10,209 properties / 1,243 docs / 7,702 workflows |
| FlexSearch (~5ms) / Schema validation / Node info / examples |
+------------------------------------------------------------------+
Contributions welcome!
- Fork the project
- Create a branch (
git checkout -b feature/amazing) - Run tests (
npm test) - Open a Pull Request
MIT License — free to use, modify, and distribute.
Third-party community workflow metadata and downloadable workflow files remain subject to their respective upstream licenses.
n8n-as-code exists because n8n exists.
Thanks to the n8n team and community for building and maintaining the workflow automation platform this project builds on.
If you use this project, consider starring the n8n repository.
If n8n-as-code saves you time, give us a ⭐ — it helps more than you think.
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}
