Как подружить n8n с кодом и перестать мучиться в браузере

Вы когда-нибудь пробовали версионировать сложные цепочки автоматизации в n8n? Если да, то наверняка знаете эту боль: экспорт JSON вручную, попытки разобрать диффы в Git, где одна измененная координата узла превращает файл в кашу, и вечное переключение между IDE и вкладкой браузера. n8n — прекрасный инструмент для визуального программирования, но как только проект разрастается, отсутствие нормальных инженерных практик начинает тормозить разработку.

Недавно я наткнулся на проект n8n-as-code от Etienne Lescot. Это не просто очередная обертка над API, а попытка превратить работу с n8n в полноценный процесс разработки через код (GitOps). Самое интересное здесь — глубокая интеграция с AI-агентами вроде Cursor или Claude Code.

n8n-as-code demo

Что это такое и зачем оно нужно

Проект решает фундаментальную проблему: n8n живет в своем закрытом мире веб-интерфейса, а разработчик — в терминале и редакторе. n8n-as-code переносит логику воркфлоу в локальные файлы.

Главная фишка в том, что инструмент «скармливает» вашему AI-агенту полную онтологию n8n. Это значит, что Claude или GPT внутри вашего редактора теперь не гадают, какие параметры есть у узла Slack или Google Sheets. Они знают схему всех 537 официальных узлов, включая типы данных и возможные опции. Это сводит галлюцинации нейросетей при написании автоматизаций практически к нулю.

Основные возможности

Синхронизация в стиле Git

Инструмент позволяет вытягивать воркфлоу из облачного или self-hosted экземпляра n8n в локальные файлы и пушить их обратно.

Есть встроенный механизм разрешения конфликтов (3-way merge).
Можно работать с несколькими инстансами n8n одновременно (например, dev и prod).
Поддерживается автоматический деплой при сохранении файла (push-on-save).

Воркфлоу на TypeScript

Это, пожалуй, самая сильная сторона для тех, кто не любит копаться в огромных JSON-файлах. Вы можете описывать логику на чистом TypeScript с использованием декораторов.

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 = {};
}

Такой подход делает код читаемым, а диффы в Git — понятными. Вы сразу видите, что изменилось в логике, а не в метаданных позиционирования узлов на холсте.

AI-ассистент с суперсилами

Если вы пользуетесь Cursor или Claude Desktop, вы можете подключить n8n-as-code как навык (skill) через MCP-протокол. Агент получает доступ к базе из 7700+ шаблонов сообщества и документации. Можно просто попросить: «Найди шаблон для отправки уведомлений из Google Sheets в Telegram и адаптируй его под мой проект». Агент найдет подходящий пример, скачает его и развернет в вашем рабочем пространстве.

Как это устроено внутри

Архитектура проекта состоит из нескольких слоев. В основе лежит CLI-утилита n8nac, которая отвечает за синхронизацию и трансформацию данных. Над ней работает слой AI Skills, который индексирует схемы узлов и документацию с помощью FlexSearch. Это позволяет искать нужную информацию за миллисекунды без обращения к внешним API.

Для визуалов есть расширение для VS Code. Оно добавляет боковую панель со списком воркфлоу и позволяет открывать встроенный холст n8n прямо в редакторе. Получается такой гибридный режим: правите код — видите изменения на схеме, и наоборот.

Практические сценарии

Кому это пригодится в первую очередь?

Командам с жестким CI/CD. Если вам нужно прогонять тесты перед тем, как изменения попадут в рабочую автоматизацию, n8n-as-code позволяет встроить пуш воркфлоу в ваши пайплайны.
Разработчикам сложных AI-агентов. Проект позволяет агенту не только писать код, но и управлять инфраструктурой n8n: создавать учетные данные (credentials), проверять ошибки выполнения и даже запускать вебхуки для тестов.
Тем, кто устал от UI. Если вам быстрее набросать структуру в коде, чем перетаскивать квадратики мышкой, TypeScript-трансформер станет вашим любимым инструментом.

Стоит ли пробовать

Проект сейчас находится в активной стадии разработки (версия 0.x), и это чувствуется. Например, нужно следить за версией n8n — если ваш инстанс сильно устарел, сгенерированные схемы могут не заработать.

Однако даже в текущем виде это огромный шаг вперед для экосистемы n8n. Возможность хранить автоматизации в Git рядом с основным кодом приложения и использовать мощь современных LLM для их написания — это именно то, чего не хватало платформе для выхода на «взрослый» уровень Enterprise-разработки.

Если вы активно используете n8n, я бы советовал как минимум поставить CLI и попробовать сделать pull своих текущих проектов. Возможно, после этого возвращаться в браузер для редактирования JSON вам больше не захочется.

Начать можно с простой команды:

npx --yes n8nac init

Она поможет настроить связь с вашим инстансом и создаст конфиг в папке проекта.