Usage
n8n-as-code uses one workflow model across all surfaces: workspace environments, explicit sync, local AI context, and local managed instances when you need them.
Command Groups
| Group | Command | Purpose |
|---|---|---|
| Primary Usage | n8nac env | Workspace environments and active sync context |
| Workspace Inspection | n8nac workspace | V4 workspace snapshot |
| Managed Local Instances | n8n-manager | Local managed instances, Docker, tunnels |
VS Code / Cursor Extension
The recommended experience. It provides the n8n sidebar, embedded canvas, explicit sync controls, n8n environments, and the integrated Agent Workbench.
CLI
Use the CLI for scripts, CI, and direct terminal workflows:
n8nac env add Dev --base-url <url> --workflows-path workflows/dev
n8nac env auth set Dev --api-key-stdin
n8nac env use Dev
n8nac list
n8nac pull <workflow-id>
n8nac push workflows/dev/my-workflow.workflow.ts --verify
n8nac promote --from Dev --to Prod --dry-run
n8n-manager
Use n8n-manager for local managed instances only: create, start, stop, remove, and expose through tunnels.
Claude Plugin
Use the same n8n skills in Claude Code or connect Claude Desktop through MCP.
Generic Agent Skills
Install the portable skills from:
https://github.com/EtienneLescot/n8n-as-code/tree/main/skills
If your agent asks for an explicit skill path, use skills/n8n-architect.
OpenClaw Plugin
Install the OpenClaw plugin for portable n8n skills, workspace setup, and natural-language workflow work.
TypeScript Workflows
An optional decorator-based format that is easier for humans and agents to read, diff, and edit.