All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
--jsonflag forwf pushandwf pullnow outputs clean JSON without progress messages
- Extract shared output utilities to
api/cli/wf/output.py(DRY refactoring) - Implement
OutputFormatterstrategy pattern for flexible output handling - Decompose
pull_workflow()andpush_workflow()into smaller helper methods - Remove unused
--tableoption fromserver listandserver keyscommands
0.9.0 - 2026-01-09
- Multi-workflow push/pull support - Push or pull multiple workflows in a single command
n8n-deploy wf push wf1 wf2 wf3 --remote myservern8n-deploy wf pull wf1 wf2 wf3 --remote myserver- Progress indicators
[1/3],[2/3],[3/3]for batch operations - Summary table showing OK/FAIL status for each workflow
- Continue processing all workflows even if some fail
- Exit code 1 if any workflow fails, 0 if all succeed
- Full backwards compatibility with single workflow usage
- Per-server SSL verification - Configure SSL settings per server (schema v8)
n8n-deploy server ssl <name> --skip-verifyto disable verificationn8n-deploy server ssl <name> --verifyto enable verification- Priority: CLI flag > server setting > default (verify)
- Workflow link command - Update workflow metadata without push/pull
n8n-deploy wf link <workflow> --flow-dir <path>to update stored pathn8n-deploy wf link <workflow> --server <name>to change linked server
- Smart workflow lookup - Flexible workflow name matching
- Case-insensitive matching:
my workflowfindsMy Workflow - Slug-style matching:
my-workflowfindsMy Workflow - Auto-append
.jsonfor filename lookup - Priority: ID → exact name → case-insensitive → slug → filename
- Case-insensitive matching:
--non-interactiveflag forwf pullto suppress prompts in automation--dband--serverflags forwf deletefor granular control
- BREAKING:
wf deletenow requires--dband/or--serverflags--db: remove from local database only--server: delete from n8n server only- Both flags: delete from server first, then database
- Local JSON files are never deleted
--filenameoption forwf pullonly works with single workflow (warning shown if used with multiple)- Default filenames (
{workflow_id}.json) used for multi-workflow pulls
- Script synchronization feature (--scripts flags removed from wf push)
0.2.0 - 2025-12-08
- Folder synchronization system for managing n8n folders
folderCLI command group for folder sync operationsFolderSyncManagerfor bidirectional folder sync between local and remoteN8nInternalClientfor n8n internal REST API integrationFolderDBclass for folder CRUD operations- Database schema v6 with new tables:
n8n_folders,folder_mappings
- Enhanced CLI verbosity
- Global
--verbose/-vflag for HTTP request logging - Extended
-vvverbosity for detailed debugging output - New
api/cli/verbose.pymodule for verbose output formatting
- Global
- HTTP client abstraction layer (
api/workflow/http_client.py) - Server resolver for flexible server selection (
api/workflow/server_resolver.py) - Shared CLI output formatting utilities (
api/cli/output.py) - Accept workflows without
idfield - auto-generatesdraft_{uuid}temporary ID (ND-47) - Automatic ID replacement with server-assigned ID after first successful push
- Workflow file renaming from
draft_*.jsonto{server_id}.jsonon push - Custom workflow filename support with basename matching (ND-50)
- BREAKING:
wf removecommand replaced withwf delete - BREAKING: Removed
server set-primarycommand from server group - API field filtering now uses whitelist approach for n8n API operations
- Refactored CLI modules to reduce cyclomatic complexity
- Workflow duplication on 404 errors during push operations
- Invalid settings fields filtered before push to n8n API
- Workflow active state preserved during push operations
- n8n internal API authentication and cookie handling
- Strip readonly fields before creating/updating workflows on n8n server
- Basename matching for filename lookup in push command (ND-50)
- Import paths updated from
api.wftoapi.workflow
0.1.7 - 2025-11-26
- CI: use
github.ref_namefor PEP 440 tag detection - CI: enable build-matrix on tag push
- CI: configure pipeline stages per trigger type
- Test subprocess timeouts increased for CI stability
- Respect
--flow-dirin push operations - Remove auto-server creation from
apikey addcommand - JSON output contaminated by wrapper script stdout
0.1.5 - 2024-11-27
- Initial release with fresh versioning
- SQLite database as single source of truth for workflow metadata
- API key management with lifecycle support (create, deactivate, delete, test)
- Server management for multiple n8n instances
- Workflow push/pull operations with n8n server API integration
- Database backup functionality with SHA256 verification
- Rich CLI output with emoji tables (optional
--no-emojifor scripts) - Flexible base folder configuration via CLI or environment variables
- Comprehensive type annotations with strict mypy compliance
- Property-based testing with Hypothesis framework
- Development status changed to Beta
- Tag format updated to PEP 440 compliant (v0.1.5rc1 instead of v0.1.5-rc1)