SKILL.md
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 templatesWorkflow 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-templateSync Workflow
flowsfarm pull- Get latest from n8n- Edit
.flowsfarm/workflows/.../workflow.json flowsfarm push- Upload changes
Use --force to overwrite on conflicts.