n8n-as-code — AI Agent Superpowers for n8n

n8n-as-code — Complete Feature Guide

Knowledge Base Stats

Core Capabilities

Schema-Aware Workflow Creation

AI agents can create valid n8n workflows because they have access to complete node schemas. The agent knows every node, every property, every valid option — no guessing, no hallucination.

TypeScript Workflow Definitions

Write n8n workflows in TypeScript instead of JSON. Bidirectional conversion between JSON and TypeScript keeps workflows version-control friendly.

// Example: TypeScript workflow definition
import { Workflow } from 'n8nac';

export default new Workflow({
  name: 'Email Classification',
  nodes: [
    Gmail.trigger({ pollTimes: '*/5 * * * *' }),
    OpenAI.classify({ model: 'gpt-4o', categories: ['urgent', 'info', 'spam'] }),
    Switch.route({ field: 'category' }),
    Slack.send({ channel: '#urgent', message: '{{ $json.subject }}' }),
  ],
});

GitOps Sync Engine

3-way merge conflict detection between local TypeScript, remote n8n JSON, and version history. Push and pull workflows like code.

Template Discovery

Search 7,700+ community templates with ~5ms FlexSearch lookup:

n8nac search "slack notification when github issue created"

Full Development Loop

Agents can:

1. Search templates for inspiration
2. Create workflows in TypeScript
3. Validate against node schemas
4. Detect missing credentials
5. Provision credentials (asking users only for secrets)
6. Deploy to n8n instance
7. Activate and monitor execution

Supported Platforms

FAQ

Q: What is n8n-as-code? A: A toolkit that gives AI coding agents complete knowledge of n8n's 537 nodes and 7,700+ templates, enabling them to create, validate, and deploy n8n workflows without hallucination or external API calls.

Q: Is n8n-as-code free? A: Yes, MIT license. You need a running n8n instance (self-hosted free, or n8n Cloud) for deployment.

Q: Does it work with Claude Code? A: Yes. Install via /plugin marketplace add EtienneLescot/n8n-as-code and the agent gains full n8n knowledge.