[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-75005":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":39,"readmeContent":40,"aiSummary":41,"trendingCount":16,"starSnapshotCount":16,"syncStatus":15,"lastSyncTime":42,"discoverSource":43},75005,"n8n-as-code","EtienneLescot\u002Fn8n-as-code","EtienneLescot","Give your AI agent n8n superpowers. 537 nodes with full schemas, 7,700+ templates, Git-like sync, and TypeScript workflows.","",null,"TypeScript",1354,164,9,2,0,35,58,168,105,19.65,"MIT License",false,"main",true,[27,28,29,30,31,32,33,34,35,36,37,38],"ai-skills","claude","copilot","cursor","gitops","low-code","n8n","ontology","skills","typescript","vscode","workflow-automation","2026-06-12 02:03:31","\u003Cdiv align=\"center\">\n\n# \u003Cimg src=\"res\u002Flogo.png\" alt=\"n8n-as-code\" width=\"40\" height=\"40\"> n8n-as-code\n\n### The agentic toolkit for n8n.\n\n**VS Code \u002F Cursor Agent · n8n Environments · n8n-manager · GitOps · AI Skills · TypeScript Workflows**\n\n[![CI](https:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code\u002Factions\u002Fworkflows\u002Fci.yml)\n[![Documentation](https:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code\u002Factions\u002Fworkflows\u002Fdocs.yml\u002Fbadge.svg)](https:\u002F\u002Fn8nascode.dev\u002F)\n[![VS Code Marketplace](https:\u002F\u002Fimg.shields.io\u002Fvisual-studio-marketplace\u002Fv\u002Fetienne-lescot.n8n-as-code?label=VS%20Code&logo=visualstudiocode)](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=etienne-lescot.n8n-as-code)\n[![Open VSX](https:\u002F\u002Fimg.shields.io\u002Fopen-vsx\u002Fv\u002Fetienne-lescot\u002Fn8n-as-code?label=Open%20VSX&logo=eclipseide)](https:\u002F\u002Fopen-vsx.org\u002Fextension\u002Fetienne-lescot\u002Fn8n-as-code)\n[![npm: cli](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fn8nac?label=cli&logo=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fn8nac)\n[![npm: skills](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@n8n-as-code\u002Fskills?label=skills&logo=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@n8n-as-code\u002Fskills)\n[![Claude Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude%20Code-Beta%20%2F%20Pending%20Review-orange)](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fusage\u002Fclaude-plugin\u002F)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\n\u003Cbr>\n\n\u003Cimg src=\"res\u002Fn8n-as-code-intro.gif\" alt=\"n8n-as-code intro\" width=\"800\">\n\n\u003Cbr>\n\n**Build, edit, deploy, and debug n8n workflows from your editor with an agent that has live n8n context.**\n\n[**Documentation**](https:\u002F\u002Fn8nascode.dev\u002F) · [**Getting Started**](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fgetting-started\u002F) · [**VS Code Guide**](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fusage\u002Fvscode-extension\u002F) · [**CLI Guide**](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fusage\u002Fcli\u002F)\n\n\u003C\u002Fdiv>\n\n---\n\n> **Using V1?** V2+ uses workspace environments. Start with the [migration guide](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fmigration\u002Fv1-to-v2\u002F) and run `n8nac workspace migrate --json` from the repository root before applying with `n8nac workspace migrate --write`. V1 users can keep using the legacy branch and packages: [V1 branch](https:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code\u002Ftree\u002Fv1) · CLI: `npx --yes n8nac@v1 \u003Ccommand>` · Claude Code: `\u002Fplugin marketplace add https:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code#v1`.\n\n> **n8n version compatibility** — The node schema bundled with n8n-as-code is built against the latest stable release of n8n. Keep your n8n instance up to date for best generation and validation results.\n\n> **Independent project** — n8n-as-code is an independent community project and is not affiliated with, endorsed by, or sponsored by n8n.\n\n---\n\n## What n8n-as-code Gives You\n\nn8n-as-code turns a repository into a full n8n development workspace:\n\n| Capability | What it means |\n|---|---|\n| **Editor-native workflow work** | Browse, open, edit, validate, and sync n8n workflows from VS Code, Cursor, or the terminal. |\n| **Agent-ready context** | Generate grounded instructions, schemas, examples, and node knowledge so AI agents can work on real n8n workflows safely. |\n| **GitOps-style sync** | Pull and push workflows explicitly, review diffs, resolve conflicts, and keep workflow source in version control. |\n| **TypeScript workflow authoring** | Convert workflows into readable `.workflow.ts` files that are easier for people and agents to edit. |\n| **Live n8n operations** | Verify workflows, inspect credentials, run tests, activate workflows, and inspect executions against a selected n8n environment. |\n\nThe repository stores workflow files, generated agent context, and workspace-safe configuration. Secrets and machine-local runtime state stay local.\n\n## Quick Start\n\n### VS Code \u002F Cursor\n\n1. Install the extension from the [VS Code Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=etienne-lescot.n8n-as-code) or [Open VSX](https:\u002F\u002Fopen-vsx.org\u002Fextension\u002Fetienne-lescot\u002Fn8n-as-code).\n2. Open a folder or `.code-workspace`.\n3. Click on the extension icon then on the gear icon to configure your workspace.\n4. Create or select an `n8n environment`.\n5. Pull or create workflows with the integrated Agent Workbench or the agent of your choice.\n\nThe configuration UI uses the same model as the CLI: workspace environments are repository context, local managed instances are machine resources.\n\n[VS Code \u002F Cursor guide](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fusage\u002Fvscode-extension\u002F)\n\n### Claude Code\n\n```text\n\u002Fplugin marketplace add https:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code\n\u002Fplugin install n8n-as-code@n8nac-marketplace\n```\n\nThen ask Claude for the workflow you want. The `n8n-architect` skill handles workspace setup, n8n context, validation, and sync steps as needed.\n\n[Claude setup docs](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fusage\u002Fclaude-plugin\u002F)\n\n### Generic Agent Skills\n\nInstall the skill from the repository skills directory:\n\n```text\nhttps:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code\u002Ftree\u002Fmain\u002Fskills\n```\n\nThen ask your agent for the workflow you want. The skill gives it the n8n schemas, examples, validation rules, and workspace commands it needs to handle the rest.\n\nIf your agent asks for an explicit skill path, use `skills\u002Fn8n-architect`.\n\n[Skills reference](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fusage\u002Fskills\u002F)\n\n### CLI\n\nCreate a workspace environment for an existing n8n URL:\n\n```bash\nnpx --yes n8nac env add Dev --base-url https:\u002F\u002Fn8n.example.com --sync-folder workflows\u002Fdev\nprintf '%s' \"$N8N_API_KEY\" | npx --yes n8nac env auth set Dev --api-key-stdin\nnpx --yes n8nac env use Dev\nnpx --yes n8nac update-ai\n```\n\nOr attach a local managed instance:\n\n```bash\nn8n-manager instance list\nnpx --yes n8nac env add Local --managed-instance \u003Cid> --sync-folder workflows\u002Flocal\nnpx --yes n8nac env use Local\n```\n\nThen sync workflows explicitly:\n\n```bash\nnpx --yes n8nac list\nnpx --yes n8nac pull \u003Cworkflow-id>\nnpx --yes n8nac push workflows\u002Fdev\u002Fmy-workflow.workflow.ts --verify\n```\n\n[CLI guide](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fusage\u002Fcli\u002F) · [n8n-manager guide](https:\u002F\u002Fn8nascode.dev\u002Fdocs\u002Fusage\u002Fn8n-manager\u002F)\n\n## Command Groups\n\n### Primary Usage: `n8nac env`\n\n```bash\nn8nac env list\nn8nac env add Dev --base-url \u003Curl> --sync-folder workflows\u002Fdev\nn8nac env add Local --managed-instance \u003Cid> --sync-folder workflows\u002Flocal\nn8nac env use Dev\nn8nac env auth set Dev --api-key-stdin\nn8nac env remove Dev\n```\n\nUse `n8nac env` for everything that describes how this repository connects to n8n.\n\n### Workspace Maintenance: `n8nac workspace`\n\n```bash\nn8nac workspace status\nn8nac workspace migrate --json\nn8nac workspace migrate --write\n```\n\nUse `workspace migrate --json` as the migration dry-run. It reports one unified `operations` list for legacy workspace and global instance changes; apply all required operations together with `workspace migrate --write`.\n\n### Managed Local Instances: `n8n-manager`\n\n```bash\nn8n-manager instance list\nn8n-manager instance create\nn8n-manager instance start \u003Cid>\nn8n-manager instance stop \u003Cid>\nn8n-manager instance remove \u003Cid>\nn8n-manager tunnel start \u003Cid>\nn8n-manager tunnel stop \u003Cid>\n```\n\nUse `n8n-manager` only for local managed instances and machine-local operations. Do not use it as the workspace source of truth.\n\n### Hidden Compatibility\n\nOlder commands can remain callable for compatibility but are not the primary model:\n\n```bash\nn8nac instance-target ...\nn8nac target ...\nn8nac setup ...\nn8nac setup-modes ...\nn8nac workspace pin-instance ...\nn8nac workspace set-sync-folder ...\n```\n\nNew docs and user flows should prefer `n8nac env`.\n\n## GitOps For n8n\n\n```bash\nn8nac env use Dev\nn8nac list\nn8nac pull \u003Cworkflow-id>\nn8nac push workflows\u002Fdev\u002Fmy-workflow.workflow.ts --verify\nn8nac resolve \u003Cworkflow-id> --mode keep-current\n```\n\nSync is explicit. Nothing is pushed or pulled unless you ask for it.\n\n## AI Skills\n\nThe skills layer gives agents grounded n8n knowledge: node schemas, docs, examples, templates, validation rules, and safe workflow operations.\n\n```bash\nnpx --yes n8nac skills search \"send slack message when google sheet is updated\"\nnpx --yes n8nac skills node-info slack\nnpx --yes n8nac skills validate workflows\u002Fdev\u002Fmy-workflow.workflow.ts\n```\n\n## TypeScript Workflows\n\n```typescript\nimport { workflow, node, links } from '@n8n-as-code\u002Ftransformer';\n\n@workflow({ id: 'abc123', name: 'Slack Notifier', active: true })\nexport class SlackNotifierWorkflow {\n  @node()\n  Trigger = {\n    type: 'n8n-nodes-base.webhook',\n    parameters: { path: '\u002Fnotify', method: 'POST' },\n    position: [250, 300],\n  };\n\n  @node()\n  Slack = {\n    type: 'n8n-nodes-base.slack',\n    parameters: {\n      resource: 'message',\n      operation: 'post',\n      channel: '#alerts',\n      text: '={{ $json.message }}',\n    },\n    position: [450, 300],\n  };\n\n  @links([{ from: 'Trigger', to: 'Slack' }])\n  connections = {};\n}\n```\n\n```bash\nn8nac convert workflow.json --format typescript\nn8nac convert-batch workflows\u002F --format typescript\n```\n\n## Packages\n\n| Package | What it does | Install |\n|:--------|:-------------|:--------|\n| **[VS Code Extension](packages\u002Fvscode-extension)** | Editor experience with sidebar, canvas, integrated Agent Workbench, and n8n environments | [Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=etienne-lescot.n8n-as-code) |\n| **[n8nac](packages\u002Fcli)** | CLI for workspace environments, sync, validation, AI context, and automation | `npx n8nac` |\n| **[Agent Skills](skills)** | Portable AI skills and embedded n8n knowledge for agents | [repo skills directory](https:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code\u002Ftree\u002Fmain\u002Fskills) |\n| **[@n8n-as-code\u002Fn8nac](plugins\u002Fopenclaw\u002Fn8n-as-code)** | OpenClaw plugin with prompt context and portable skills | `openclaw plugins install @n8n-as-code\u002Fn8nac` |\n| **[@n8n-as-code\u002Ftransformer](packages\u002Ftransformer)** | JSON to TypeScript workflow converter and back | `npm i @n8n-as-code\u002Ftransformer` |\n\n## How The Pieces Fit\n\n- **VS Code\u002FCursor extension**: visual workflow workspace and integrated Agent Workbench.\n- **`n8nac env`**: repository-level environment source of truth.\n- **`n8nac workspace`**: readiness and unified workspace migration.\n- **`n8n-manager`**: local managed instances, Docker lifecycle, tunnels, and machine-local secrets.\n- **Skills and MCP**: grounded n8n knowledge for agents.\n\n## Contributing\n\nContributions welcome.\n\n1. Fork the project.\n2. Create a branch: `git checkout -b feature\u002Famazing`.\n3. Run tests: `npm test`.\n4. Open a Pull Request.\n\n## License\n\n[MIT License](LICENSE) — free to use, modify, and distribute.\n\nThird-party community workflow metadata and downloadable workflow files remain subject to their respective upstream licenses.\n\n## Acknowledgements\n\n`n8n-as-code` exists because [n8n](https:\u002F\u002Fn8n.io\u002F) exists.\n\nThanks to the n8n team and community for building and maintaining the workflow automation platform this project builds on.\n\n\u003Cdiv align=\"center\">\n\n**If n8n-as-code saves you time, give us a star.**\n\n[Star on GitHub](https:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code) · [Documentation](https:\u002F\u002Fn8nascode.dev\u002F) · [Report a Bug](https:\u002F\u002Fgithub.com\u002FEtienneLescot\u002Fn8n-as-code\u002Fissues)\n\n\u003C\u002Fdiv>\n","n8n-as-code 是一个将 AI 代理与 n8n 工作流集成的工具包。它提供了 537 个节点、7,700 多个模板以及 GitOps 同步功能，支持使用 TypeScript 编写工作流。核心功能包括在 VS Code 或终端中浏览、编辑和同步 n8n 工作流，并通过 Git 进行版本控制。此外，该项目还集成了低代码开发环境和 AI 技能，方便用户快速构建自动化流程。适用于需要高效管理和部署复杂工作流的开发者，特别是在涉及多步骤业务逻辑自动化时。","2026-06-11 03:51:54","high_star"]