EtienneLescot/n8n-as-code

Give your AI agent n8n superpowers. 537 nodes with full schemas, 7,700+ templates, Git-like sync, and TypeScript workflows.

What it solves

It transforms n8n workflow development from a purely visual interface into a code-centric, agent-ready workspace. This allows developers to use version control (GitOps), edit workflows in a professional IDE, and enable AI agents to build and debug workflows with grounded, real-time context of the n8n environment.

How it works

The project provides a suite of tools that bridge the gap between n8n's JSON-based workflows and a developer's editor:

  • CLI and Extensions: A VS Code/Cursor extension and a CLI (n8nac) manage environments, sync workflows between the editor and n8n instances, and handle validation.
  • TypeScript Transformation: It converts n8n's JSON workflows into readable .workflow.ts files, making them easier for both humans and AI agents to modify.
  • Agent Skills: It provides a "skills" layer containing node schemas, documentation, and validation rules that can be plugged into AI agents (like Claude Code or Cursor) so they can generate valid n8n workflows.
  • Environment Management: It manages multiple n8n environments (e.g., Dev, Prod) and supports local managed instances via n8n-manager.

Who it’s for

  • n8n users who want to move beyond the visual editor for complex workflows.
  • Developers who want to implement GitOps for their automation pipelines.
  • AI Engineers building agents that can autonomously create or maintain n8n workflows.

Highlights

  • Agent-ready context: Provides grounded instructions and schemas for AI agents to work safely.
  • GitOps-style sync: Explicit pull/push workflows with diff reviews and conflict resolution.
  • TypeScript authoring: Ability to convert workflows to TypeScript for better readability and maintainability.
  • Environment Promotion: Tools to move workflows from one environment to another while remapping credentials and references.
  • IDE Integration: Native support for VS Code and Cursor with an integrated Agent Workbench.

Related

  • Project
    n8n-io/n8n

    n8n is a fair-code platform for building and deploying AI agents and automated workflows, connecting over 1,500 integrations with flexible model support.

  • Project
    google/adk-js

    A code-first TypeScript toolkit for building, orchestrating, and deploying AI agents with full type safety and support for both Node.js and browser environments.

  • Project
    codeany-ai/open-agent-sdk-typescript

    An open-source TypeScript SDK for running autonomous AI agents in-process, featuring a vast library of built-in tools and support for multiple LLM providers.

  • Project
    czlonkowski/n8n-mcp

    n8n‑MCP is a Model Context Protocol server that exposes the full n8n node catalog (≈3 000 nodes) as an API. AI assistants can search nodes, fetch detailed property schemas, get documentation, pull example configurations, and retrieve ready‑made workflow templates. The service also offers validation tools and, when given n8n credentials, can create, update, test, and manage workflows directly. It’s designed to let LLMs reliably build and deploy n8n automations.

  • Project
    OpenHands/software-agent-sdk

    A developer SDK providing APIs to build AI agents that can write code, manage files, and execute terminal commands in local or ephemeral workspaces.