flowsfarm

name	flowsfarm
description	Manage n8n workflows with FlowsFarm CLI. Use when user wants to sync, create, edit, or manage n8n workflows locally. Triggers for n8n automation tasks, workflow version control, or multi-instance workflow management.

FlowsFarm CLI

Local-first n8n workflow synchronization. Requires bun runtime.

Setup

# Install
bun install -g flowsfarm

# Initialize in project
flowsfarm init

# Add n8n connection (requires API key from n8n settings)
flowsfarm connect add -n <name> -u <url> -k <api-key>

Core Commands

Command	Description
flowsfarm pull	Download workflows from n8n
flowsfarm push	Upload local changes to n8n
flowsfarm status	Show sync status
flowsfarm diff	Show differences
flowsfarm list	List workflows
flowsfarm list --json	List as JSON
flowsfarm show <name>	Show workflow details
flowsfarm show <name> --json	Full workflow JSON
flowsfarm create <name>	Create empty workflow
flowsfarm create <name> -t <template>	Create from template

File Structure

.flowsfarm/
├── flowsfarm.db              # SQLite metadata
├── workflows/<conn>/<id>/
│   └── workflow.json         # Editable workflow
└── templates/*.json          # Reusable templates

Workflow JSON

{
  "name": "Workflow Name",
  "active": false,
  "nodes": [
    {
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "position": [250, 300],
      "parameters": {
        "url": "https://api.example.com",
        "method": "GET"
      }
    }
  ],
  "connections": {
    "Trigger": {
      "main": [[{ "node": "HTTP Request", "type": "main", "index": 0 }]]
    }
  }
}

Common Node Types

Type	Purpose
n8n-nodes-base.webhook	HTTP trigger
n8n-nodes-base.schedule	Cron trigger
n8n-nodes-base.httpRequest	API calls
n8n-nodes-base.code	JavaScript/Python
n8n-nodes-base.if	Conditional
n8n-nodes-base.switch	Multi-condition
n8n-nodes-base.set	Transform data
n8n-nodes-base.merge	Combine streams

Templates

# Save workflow as template
flowsfarm templates save "My Workflow" -n my-template

# List templates
flowsfarm templates

# Create from template
flowsfarm create "New Workflow" -t my-template

Sync Workflow

1. flowsfarm pull - Get latest from n8n
2. Edit .flowsfarm/workflows/.../workflow.json
3. flowsfarm push - Upload changes

Use --force to overwrite on conflicts.