cyberneticlibrary

Track and create workflow branches

n8n-branchcommandsetup L13
OpenAnalystInc/10x-n8n-skill
What it does

List tracked n8n workflow branches or create a new one

Best for

Tracking multiple n8n workflow versions locally and switching between branches during active development

Inputs
  • · Optional argument: 'create <name>' or '--list'
  • · .n8n-track/branches.json tracking file
  • · .n8n-track/HEAD.json current branch marker
Outputs
  • · List of branches with workflow ID, status (active/inactive), node count, commit count
  • · Current branch marked with '*'
  • · New branch snapshot and init commit created if create argument provided
Requires
  • · n8n REST API (POST /api/v1/workflows for new workflow)
  • · Read/Write (.n8n-track/branches.json, .n8n-track/HEAD.json)
Preconditions
  • · .n8n-track/ directory initialized
  • · branches.json and HEAD.json files exist
  • · n8n API accessible (for create operations)
Failure modes
  • · .n8n-track/ not initialized
  • · n8n API unavailable or authentication fails
  • · Branch name conflicts with existing branch
  • · Invalid create syntax (missing name argument)
Trust signals
  • · Enforces naming (workflow-<id>)
  • · Keeps main branch as instance state reference
  • · Stores initial snapshots and tracks commits per branch
  • · Shows node count and commit history for quick context