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

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

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.