kctl-n8n 0.2.0__tar.gz

kctl_n8n-0.2.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local

kctl_n8n-0.2.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: kctl-n8n
+Version: 0.2.0
+Summary: Kodemeio n8n CLI — manage n8n workflow automation instances via the public REST API
+Author-email: Kodemeio <dev@kodeme.io>
+License-Expression: MIT
+Keywords: automation,cli,kodemeio,n8n,workflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: kctl-lib>=0.8.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: rich>=13.9.0
+Requires-Dist: typer>=0.15.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.14.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.35.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.0; extra == 'dev'
+Requires-Dist: ruff>=0.9.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# kctl-n8n
+
+Kodemeio CLI for [n8n](https://n8n.io) workflow automation instances.
+
+Wraps the n8n public REST API with the same UX patterns as the rest of the `kctl-*` suite (profiles, shared config at `~/.config/kodemeio/config.yaml`, `--json` output, rich tables).
+
+## Install
+
+```bash
+uv tool install --reinstall --from packages/kctl-n8n kctl-n8n
+```
+
+## Quick start
+
+```bash
+# Configure a profile
+kctl-n8n config init --name idtpp --url https://n8n.idtpp.com --api-key "$N8N_API_KEY"
+
+# Use it
+kctl-n8n -p idtpp health
+kctl-n8n -p idtpp workflows list
+kctl-n8n -p idtpp executions list --limit 10
+```
+
+## Command groups
+
+| Group | Purpose |
+|---|---|
+| `workflows` | list / get / create / update / delete / activate / deactivate / transfer / tags |
+| `executions` | list / get / delete past workflow runs |
+| `credentials` | create / delete / schema / transfer credentials |
+| `users` | list / get / create / delete / change-role |
+| `variables` | list / create / update / delete environment variables |
+| `tags` | list / get / create / update / delete tags |
+| `projects` | list / create / update / delete projects (Enterprise) |
+| `audit` | generate audit reports |
+| `source-control` | pull / push for Git-based workflow management |
+| `config` | manage profiles in `~/.config/kodemeio/config.yaml` |
+| `health` | `/healthz` check |
+| `dashboard` | high-level instance overview |
+| `doctor` | diagnostic checks |
+| `skill` | generate the `n8n-admin` Claude Code skill + install MCP skills |
+
+## Profile config
+
+Stored under `~/.config/kodemeio/config.yaml` with service key `n8n`:
+
+```yaml
+profiles:
+  idtpp:
+    n8n:
+      url: https://n8n.idtpp.com
+      api_key: ${N8N_IDTPP_API_KEY}     # env var expansion supported
+      tenant: tpp                        # optional
+```
+
+## Skills
+
+`kctl-n8n` bundles 8 Claude Code skills (one CLI-admin skill + 7 n8n-mcp workflow skills from [czlonkowski/n8n-skills](https://github.com/czlonkowski/n8n-skills)):
+
+```bash
+kctl-n8n skill generate                 # install n8n-admin SKILL.md to ~/.claude/skills/
+kctl-n8n skill install-mcp-skills       # install all 7 workflow-building skills
+kctl-n8n skill list                     # show what's installed
+```

kctl_n8n-0.2.0/README.md

@@ -0,0 +1,65 @@
+# kctl-n8n
+
+Kodemeio CLI for [n8n](https://n8n.io) workflow automation instances.
+
+Wraps the n8n public REST API with the same UX patterns as the rest of the `kctl-*` suite (profiles, shared config at `~/.config/kodemeio/config.yaml`, `--json` output, rich tables).
+
+## Install
+
+```bash
+uv tool install --reinstall --from packages/kctl-n8n kctl-n8n
+```
+
+## Quick start
+
+```bash
+# Configure a profile
+kctl-n8n config init --name idtpp --url https://n8n.idtpp.com --api-key "$N8N_API_KEY"
+
+# Use it
+kctl-n8n -p idtpp health
+kctl-n8n -p idtpp workflows list
+kctl-n8n -p idtpp executions list --limit 10
+```
+
+## Command groups
+
+| Group | Purpose |
+|---|---|
+| `workflows` | list / get / create / update / delete / activate / deactivate / transfer / tags |
+| `executions` | list / get / delete past workflow runs |
+| `credentials` | create / delete / schema / transfer credentials |
+| `users` | list / get / create / delete / change-role |
+| `variables` | list / create / update / delete environment variables |
+| `tags` | list / get / create / update / delete tags |
+| `projects` | list / create / update / delete projects (Enterprise) |
+| `audit` | generate audit reports |
+| `source-control` | pull / push for Git-based workflow management |
+| `config` | manage profiles in `~/.config/kodemeio/config.yaml` |
+| `health` | `/healthz` check |
+| `dashboard` | high-level instance overview |
+| `doctor` | diagnostic checks |
+| `skill` | generate the `n8n-admin` Claude Code skill + install MCP skills |
+
+## Profile config
+
+Stored under `~/.config/kodemeio/config.yaml` with service key `n8n`:
+
+```yaml
+profiles:
+  idtpp:
+    n8n:
+      url: https://n8n.idtpp.com
+      api_key: ${N8N_IDTPP_API_KEY}     # env var expansion supported
+      tenant: tpp                        # optional
+```
+
+## Skills
+
+`kctl-n8n` bundles 8 Claude Code skills (one CLI-admin skill + 7 n8n-mcp workflow skills from [czlonkowski/n8n-skills](https://github.com/czlonkowski/n8n-skills)):
+
+```bash
+kctl-n8n skill generate                 # install n8n-admin SKILL.md to ~/.claude/skills/
+kctl-n8n skill install-mcp-skills       # install all 7 workflow-building skills
+kctl-n8n skill list                     # show what's installed
+```

kctl_n8n-0.2.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "kctl-n8n"
+version = "0.2.0"
+description = "Kodemeio n8n CLI — manage n8n workflow automation instances via the public REST API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+authors = [{ name = "Kodemeio", email = "dev@kodeme.io" }]
+keywords = ["n8n", "workflow", "automation", "cli", "kodemeio"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Systems Administration",
+]
+dependencies = [
+    "kctl-lib>=0.8.0",
+    "typer>=0.15.0",
+    "httpx>=0.28.0",
+    "rich>=13.9.0",
+    "pydantic>=2.10.0",
+    "pyyaml>=6.0.2",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3.0",
+    "pytest-httpx>=0.35.0",
+    "ruff>=0.9.0",
+    "mypy>=1.14.0",
+    "types-PyYAML>=6.0.0",
+]
+
+[project.scripts]
+kctl-n8n = "kctl_n8n.cli:_run"
+
+[tool.uv.sources]
+kctl-lib = { workspace = true }
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/kctl_n8n"]
+# Bundle the n8n-admin skill + the czlonkowski n8n-skills as package data
+artifacts = [
+    "src/kctl_n8n/_skills/**",
+]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "UP", "B", "SIM"]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true

kctl_n8n-0.2.0/src/kctl_n8n/__init__.py

@@ -0,0 +1,3 @@
+"""kctl-n8n — Kodemeio CLI for n8n workflow automation."""
+
+__version__ = "0.2.0"

kctl_n8n-0.2.0/src/kctl_n8n/__main__.py

@@ -0,0 +1,6 @@
+"""Allow `python -m kctl_n8n` to launch the CLI."""
+
+from kctl_n8n.cli import _run
+
+if __name__ == "__main__":
+    _run()

kctl_n8n-0.2.0/src/kctl_n8n/_skills/mcp/.upstream

@@ -0,0 +1,3 @@
+source: https://github.com/czlonkowski/n8n-skills
+commit: 27e9d0ab92cccfc46db4f147497b173f214b69c5
+synced_at: 2026-05-20T16:52:32+07:00