Skip to main content

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kctl_n8n-0.6.1.tar.gz (176.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kctl_n8n-0.6.1-py3-none-any.whl (223.0 kB view details)

Uploaded Python 3

File details

Details for the file kctl_n8n-0.6.1.tar.gz.

File metadata

  • Download URL: kctl_n8n-0.6.1.tar.gz
  • Upload date:
  • Size: 176.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.20 {"installer":{"name":"uv","version":"0.11.20","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

Hashes for kctl_n8n-0.6.1.tar.gz
Algorithm Hash digest
SHA256 6cdb966523c9c509ea7a516aa7eb6a8ca8a278b0a1b859b2e1bfe4e92f3752e7
MD5 824f703910b46ee5491743a184586969
BLAKE2b-256 c9d15ba1744b81dc44ceef58cd67fa8ea4eea72c71ba38e8ab108566f012f95a

See more details on using hashes here.

File details

Details for the file kctl_n8n-0.6.1-py3-none-any.whl.

File metadata

  • Download URL: kctl_n8n-0.6.1-py3-none-any.whl
  • Upload date:
  • Size: 223.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.20 {"installer":{"name":"uv","version":"0.11.20","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

Hashes for kctl_n8n-0.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2c23c8403df10840f940c13ea2efd9bf1bfcf8fb69c7d2604bd4f3da19566d44
MD5 d9947e788250d1b49bf597a463f5cf24
BLAKE2b-256 f5a6f463fe0c8774faf45f84a2c72286fbb3e9f5a76f2b76545c889f1eae48fc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page