# n8n-decanter

> The toolkit for building code-heavy n8n workflows — agent-first, MCP-native. Every Code node's source becomes its own .js/.ts file in git: typed TypeScript with shared libraries, verified by preflights (offline check/simulate, instance-side test, or the preflight gate that scores the whole ladder), and synced draft-first over n8n's built-in MCP server. It also guards your agent's access to n8n's full MCP surface — create, read, update, and rename whole workflows through it, with only Code-node writes redirected to files — and mirrors each workflow's structure into a read-only snapshot.

## Getting started

- [Installation](https://buttjer.github.io/n8n-decanter/docs/getting-started/installation/)
- [Quickstart](https://buttjer.github.io/n8n-decanter/docs/getting-started/quickstart/)

## CLI reference

- [Overview](https://buttjer.github.io/n8n-decanter/docs/cli/overview/)
- [init](https://buttjer.github.io/n8n-decanter/docs/cli/init/)
- [pull](https://buttjer.github.io/n8n-decanter/docs/cli/pull/)
- [push](https://buttjer.github.io/n8n-decanter/docs/cli/push/)
- [diff](https://buttjer.github.io/n8n-decanter/docs/cli/diff/)
- [watch](https://buttjer.github.io/n8n-decanter/docs/cli/watch/)
- [publish / unpublish](https://buttjer.github.io/n8n-decanter/docs/cli/publish/)
- [preflight](https://buttjer.github.io/n8n-decanter/docs/cli/preflight/)
- [test](https://buttjer.github.io/n8n-decanter/docs/cli/test/)
- [mcp connect](https://buttjer.github.io/n8n-decanter/docs/cli/mcp-connect/)
- [mcp serve](https://buttjer.github.io/n8n-decanter/docs/cli/mcp-serve/)
- [executions](https://buttjer.github.io/n8n-decanter/docs/cli/executions/)
- [data-tables](https://buttjer.github.io/n8n-decanter/docs/cli/data-tables/)
- [scenario](https://buttjer.github.io/n8n-decanter/docs/cli/scenario/)
- [list](https://buttjer.github.io/n8n-decanter/docs/cli/list/)
- [backup](https://buttjer.github.io/n8n-decanter/docs/cli/backup/)
- [node run](https://buttjer.github.io/n8n-decanter/docs/cli/node-run/)
- [completion](https://buttjer.github.io/n8n-decanter/docs/cli/completion/)

## Concepts

- [Sync layout & data model](https://buttjer.github.io/n8n-decanter/docs/concepts/sync-layout/)
- [TypeScript nodes & bundling](https://buttjer.github.io/n8n-decanter/docs/concepts/typescript-nodes/)
- [Push gates](https://buttjer.github.io/n8n-decanter/docs/concepts/push-gates/)
- [Configuration](https://buttjer.github.io/n8n-decanter/docs/concepts/configuration/)
- [Type checking](https://buttjer.github.io/n8n-decanter/docs/concepts/type-checking/)

## Agents

- [Working with coding agents](https://buttjer.github.io/n8n-decanter/docs/agents/overview/)
- [The offline feedback loop](https://buttjer.github.io/n8n-decanter/docs/agents/offline-loop/)
- [Using n8n's official skills](https://buttjer.github.io/n8n-decanter/docs/agents/n8n-skills/)

## Help

- [FAQ & troubleshooting](https://buttjer.github.io/n8n-decanter/docs/faq/troubleshooting/)