Kodemeio n8n CLI — manage n8n workflow automation instances via the public REST API
Project description
kctl-n8n
Kodemeio CLI for n8n 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
uv tool install --reinstall --from packages/kctl-n8n kctl-n8n
Quick start
# 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:
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):
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kctl_n8n-0.5.0.tar.gz.
File metadata
- Download URL: kctl_n8n-0.5.0.tar.gz
- Upload date:
- Size: 176.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d709421f992eea7deb87b43aae51e553ac3c30f46952f40f6d1b4367b90697d2
|
|
| MD5 |
e9972a350b4cae36cab4b415d8cd42cf
|
|
| BLAKE2b-256 |
08bdd7295f9769587ad92fd9da3321c3b1fa7c4617be4d499043e0685a0f3097
|
File details
Details for the file kctl_n8n-0.5.0-py3-none-any.whl.
File metadata
- Download URL: kctl_n8n-0.5.0-py3-none-any.whl
- Upload date:
- Size: 223.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9a9a2b657b90479fd7d0285b63e0803ac8d1c3a03df09b43d935d139c7a393dc
|
|
| MD5 |
511203c22cc6f841f12b331d86db1f34
|
|
| BLAKE2b-256 |
10002c51d7ba3a38cbc0f8e9c36d0810c3dcba8760fcfe073a7bd1b0469f9a6e
|
