cli-anything-n8n 1.1.0__tar.gz

cli_anything_n8n-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Juan Jose Sanchez Bernal / Webcomunica Soluciones Informaticas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cli_anything_n8n-1.1.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.2
+Name: cli-anything-n8n
+Version: 1.1.0
+Summary: CLI harness for n8n workflow automation — CLI-Anything pattern (n8n API v1.1.1)
+Author-email: Juan Jose Sanchez Bernal <info@webcomunica.solutions>
+Maintainer-email: Webcomunica Soluciones Informaticas <info@webcomunica.solutions>
+License: MIT
+Project-URL: Homepage, https://webcomunica.solutions
+Project-URL: Documentation, https://optimizaconia.es
+Project-URL: Repository, https://github.com/webcomunicasolutions/cli-n8n
+Project-URL: Issues, https://github.com/webcomunicasolutions/cli-n8n/issues
+Project-URL: Changelog, https://github.com/webcomunicasolutions/cli-n8n/blob/main/CHANGELOG.md
+Keywords: n8n,cli,workflow,automation,cli-anything,ai-agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: requests>=2.28.0
+
+# cli-anything-n8n
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![CLI-Anything](https://img.shields.io/badge/CLI--Anything-harness-orange.svg)](https://github.com/HKUDS/CLI-Anything)
+[![n8n API v1.1.1](https://img.shields.io/badge/n8n-API%20v1.1.1-EA4B71.svg)](https://docs.n8n.io/api/api-reference/)
+[![n8n >= 1.0.0](https://img.shields.io/badge/n8n-%3E%3D%201.0.0-EA4B71.svg)]()
+[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)]()
+
+> [Leer en Español](#spanish) | [Read in English](#english)
+
+---
+
+<a id="english"></a>
+
+## English
+
+CLI harness for [n8n](https://n8n.io) workflow automation — built with the [CLI-Anything](https://github.com/HKUDS/CLI-Anything) pattern.
+
+Created as a **community contribution** to bring n8n into the CLI-Anything ecosystem. Verified against the **n8n OpenAPI spec v1.1.1** (n8n 2.43.0) — only endpoints that actually exist in the public API are exposed.
+
+### Features
+
+- **Verified n8n Public API coverage**: workflows, executions, credentials, variables, tags
+- **Interactive REPL mode** with colored output, truncation indicators, and table formatting
+- **JSON output** for AI agent consumption (`--json`)
+- **Config persistence** at `~/.cli-anything/n8n/config.json`
+- **Robust error handling**: clean messages for HTTP errors, connection failures, invalid JSON
+- **PEP 420 namespace packaging** — coexists with other CLI-Anything harnesses
+
+### Quick Start
+
+```bash
+pip install cli-anything-n8n
+
+# Configure
+export N8N_BASE_URL=https://your-n8n.example.com
+export N8N_API_KEY=your-api-key
+
+# Use
+cli-anything-n8n workflow list
+cli-anything-n8n --json execution list --status error
+cli-anything-n8n tag create "production"
+```
+
+Or use the interactive REPL:
+
+```bash
+cli-anything-n8n
+n8n> workflow list --active
+n8n> execution list --status error
+n8n> exit
+```
+
+### Command Groups
+
+| Group | Commands | API Endpoints |
+|-------|----------|---------------|
+| `workflow` | list, get, create, update, delete, activate, deactivate, tags, set-tags, transfer | 9 |
+| `execution` | list, get, delete, retry | 4 |
+| `credential` | create, delete, schema, transfer | 4 |
+| `variable` | list, create, update, delete | 4 |
+| `tag` | list, get, create, update, delete | 5 |
+| `config` | show, set | - |
+
+> **Note**: Some n8n features (Data Tables, credential listing, execution stop) are not available through the public API. This CLI only exposes verified, working endpoints.
+
+### Configuration
+
+Three ways to configure (in priority order):
+
+1. **CLI flags**: `--url` and `--api-key`
+2. **Environment variables**: `N8N_BASE_URL`, `N8N_API_KEY`, `N8N_TIMEOUT`
+3. **Config file**: `cli-anything-n8n config set base_url https://...`
+
+### For AI Agents
+
+- Always use `--json` for structured, parseable output
+- Use `@file.json` to pass complex JSON payloads
+- Check return codes: 0 = success, non-zero = error
+- Workflow and execution IDs are strings
+- Set `N8N_TIMEOUT` env var for long-running operations (default: 30s)
+
+### n8n Compatibility
+
+| n8n Version | API Version | Status |
+|-------------|-------------|--------|
+| >= 1.0.0 | v1.1.1 | Verified |
+| 2.43.0 | v1.1.1 | Tested (E2E) |
+
+### Development
+
+```bash
+git clone https://github.com/webcomunicasolutions/cli-n8n.git
+cd cli-n8n
+pip install -e .
+pytest cli_anything/n8n/tests/test_core.py -v        # unit tests (no n8n needed)
+pytest cli_anything/n8n/tests/test_full_e2e.py -v     # E2E (requires running n8n)
+```
+
+### Architecture
+
+```
+cli_anything/n8n/
+├── n8n_cli.py              # Click CLI + REPL
+├── core/                   # Business logic (thin API wrappers)
+│   ├── workflows.py        # Workflow CRUD, activate/deactivate, tags, transfer
+│   ├── executions.py       # Execution list, get, delete, retry
+│   ├── credentials.py      # Credential create, delete, schema, transfer
+│   ├── variables.py        # Variable CRUD
+│   ├── tags.py             # Tag CRUD
+│   └── project.py          # Config load/save
+├── utils/
+│   ├── n8n_backend.py      # HTTP client (sole point of contact with n8n API)
+│   └── repl_skin.py        # Terminal UI (banner, colors, tables)
+├── skills/
+│   └── SKILL.md            # AI agent discovery document
+└── tests/
+    ├── test_core.py        # Unit tests (mocked)
+    └── test_full_e2e.py    # E2E lifecycle tests
+```
+
+### License
+
+MIT
+
+---
+
+<a id="spanish"></a>
+
+## Español
+
+CLI harness para [n8n](https://n8n.io) (automatizacion de workflows) — construido con el patron [CLI-Anything](https://github.com/HKUDS/CLI-Anything).
+
+Creado como **contribucion a la comunidad** para integrar n8n en el ecosistema CLI-Anything. Verificado contra la **especificacion OpenAPI v1.1.1 de n8n** (n8n 2.43.0) — solo se exponen endpoints que realmente existen en la API publica.
+
+### Caracteristicas
+
+- **Cobertura verificada de la API publica de n8n**: workflows, ejecuciones, credenciales, variables, tags
+- **Modo REPL interactivo** con salida coloreada, indicadores de truncado y tablas
+- **Salida JSON** para consumo por agentes IA (`--json`)
+- **Configuracion persistente** en `~/.cli-anything/n8n/config.json`
+- **Manejo robusto de errores**: mensajes claros para errores HTTP, fallos de conexion, JSON invalido
+- **PEP 420 namespace packaging** — coexiste con otros harnesses de CLI-Anything
+
+### Inicio rapido
+
+```bash
+pip install cli-anything-n8n
+
+# Configurar
+export N8N_BASE_URL=https://tu-instancia-n8n.example.com
+export N8N_API_KEY=tu-api-key
+
+# Usar
+cli-anything-n8n workflow list
+cli-anything-n8n --json execution list --status error
+cli-anything-n8n tag create "produccion"
+```
+
+### Grupos de comandos
+
+| Grupo | Comandos | Endpoints API |
+|-------|----------|---------------|
+| `workflow` | list, get, create, update, delete, activate, deactivate, tags, set-tags, transfer | 9 |
+| `execution` | list, get, delete, retry | 4 |
+| `credential` | create, delete, schema, transfer | 4 |
+| `variable` | list, create, update, delete | 4 |
+| `tag` | list, get, create, update, delete | 5 |
+| `config` | show, set | - |
+
+> **Nota**: Algunas funcionalidades de n8n (Data Tables, listar credenciales, parar ejecuciones) no estan disponibles via la API publica. Este CLI solo expone endpoints verificados y funcionales.
+
+### Compatibilidad con n8n
+
+| Version n8n | Version API | Estado |
+|-------------|-------------|--------|
+| >= 1.0.0 | v1.1.1 | Verificado |
+| 2.43.0 | v1.1.1 | Testeado (E2E) |
+
+### Desarrollo
+
+```bash
+git clone https://github.com/webcomunicasolutions/cli-n8n.git
+cd cli-n8n
+pip install -e .
+pytest cli_anything/n8n/tests/test_core.py -v        # tests unitarios
+pytest cli_anything/n8n/tests/test_full_e2e.py -v     # E2E (requiere n8n corriendo)
+```
+
+### Licencia
+
+MIT

cli_anything_n8n-1.1.0/cli_anything/n8n/README.md

@@ -0,0 +1,193 @@
+# cli-anything-n8n
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![CLI-Anything](https://img.shields.io/badge/CLI--Anything-harness-orange.svg)](https://github.com/HKUDS/CLI-Anything)
+[![n8n API v1.1.1](https://img.shields.io/badge/n8n-API%20v1.1.1-EA4B71.svg)](https://docs.n8n.io/api/api-reference/)
+[![n8n >= 1.0.0](https://img.shields.io/badge/n8n-%3E%3D%201.0.0-EA4B71.svg)]()
+[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)]()
+
+> [Leer en Español](#spanish) | [Read in English](#english)
+
+---
+
+<a id="english"></a>
+
+## English
+
+CLI harness for [n8n](https://n8n.io) workflow automation — built with the [CLI-Anything](https://github.com/HKUDS/CLI-Anything) pattern.
+
+Created as a **community contribution** to bring n8n into the CLI-Anything ecosystem. Verified against the **n8n OpenAPI spec v1.1.1** (n8n 2.43.0) — only endpoints that actually exist in the public API are exposed.
+
+### Features
+
+- **Verified n8n Public API coverage**: workflows, executions, credentials, variables, tags
+- **Interactive REPL mode** with colored output, truncation indicators, and table formatting
+- **JSON output** for AI agent consumption (`--json`)
+- **Config persistence** at `~/.cli-anything/n8n/config.json`
+- **Robust error handling**: clean messages for HTTP errors, connection failures, invalid JSON
+- **PEP 420 namespace packaging** — coexists with other CLI-Anything harnesses
+
+### Quick Start
+
+```bash
+pip install cli-anything-n8n
+
+# Configure
+export N8N_BASE_URL=https://your-n8n.example.com
+export N8N_API_KEY=your-api-key
+
+# Use
+cli-anything-n8n workflow list
+cli-anything-n8n --json execution list --status error
+cli-anything-n8n tag create "production"
+```
+
+Or use the interactive REPL:
+
+```bash
+cli-anything-n8n
+n8n> workflow list --active
+n8n> execution list --status error
+n8n> exit
+```
+
+### Command Groups
+
+| Group | Commands | API Endpoints |
+|-------|----------|---------------|
+| `workflow` | list, get, create, update, delete, activate, deactivate, tags, set-tags, transfer | 9 |
+| `execution` | list, get, delete, retry | 4 |
+| `credential` | create, delete, schema, transfer | 4 |
+| `variable` | list, create, update, delete | 4 |
+| `tag` | list, get, create, update, delete | 5 |
+| `config` | show, set | - |
+
+> **Note**: Some n8n features (Data Tables, credential listing, execution stop) are not available through the public API. This CLI only exposes verified, working endpoints.
+
+### Configuration
+
+Three ways to configure (in priority order):
+
+1. **CLI flags**: `--url` and `--api-key`
+2. **Environment variables**: `N8N_BASE_URL`, `N8N_API_KEY`, `N8N_TIMEOUT`
+3. **Config file**: `cli-anything-n8n config set base_url https://...`
+
+### For AI Agents
+
+- Always use `--json` for structured, parseable output
+- Use `@file.json` to pass complex JSON payloads
+- Check return codes: 0 = success, non-zero = error
+- Workflow and execution IDs are strings
+- Set `N8N_TIMEOUT` env var for long-running operations (default: 30s)
+
+### n8n Compatibility
+
+| n8n Version | API Version | Status |
+|-------------|-------------|--------|
+| >= 1.0.0 | v1.1.1 | Verified |
+| 2.43.0 | v1.1.1 | Tested (E2E) |
+
+### Development
+
+```bash
+git clone https://github.com/webcomunicasolutions/cli-n8n.git
+cd cli-n8n
+pip install -e .
+pytest cli_anything/n8n/tests/test_core.py -v        # unit tests (no n8n needed)
+pytest cli_anything/n8n/tests/test_full_e2e.py -v     # E2E (requires running n8n)
+```
+
+### Architecture
+
+```
+cli_anything/n8n/
+├── n8n_cli.py              # Click CLI + REPL
+├── core/                   # Business logic (thin API wrappers)
+│   ├── workflows.py        # Workflow CRUD, activate/deactivate, tags, transfer
+│   ├── executions.py       # Execution list, get, delete, retry
+│   ├── credentials.py      # Credential create, delete, schema, transfer
+│   ├── variables.py        # Variable CRUD
+│   ├── tags.py             # Tag CRUD
+│   └── project.py          # Config load/save
+├── utils/
+│   ├── n8n_backend.py      # HTTP client (sole point of contact with n8n API)
+│   └── repl_skin.py        # Terminal UI (banner, colors, tables)
+├── skills/
+│   └── SKILL.md            # AI agent discovery document
+└── tests/
+    ├── test_core.py        # Unit tests (mocked)
+    └── test_full_e2e.py    # E2E lifecycle tests
+```
+
+### License
+
+MIT
+
+---
+
+<a id="spanish"></a>
+
+## Español
+
+CLI harness para [n8n](https://n8n.io) (automatizacion de workflows) — construido con el patron [CLI-Anything](https://github.com/HKUDS/CLI-Anything).
+
+Creado como **contribucion a la comunidad** para integrar n8n en el ecosistema CLI-Anything. Verificado contra la **especificacion OpenAPI v1.1.1 de n8n** (n8n 2.43.0) — solo se exponen endpoints que realmente existen en la API publica.
+
+### Caracteristicas
+
+- **Cobertura verificada de la API publica de n8n**: workflows, ejecuciones, credenciales, variables, tags
+- **Modo REPL interactivo** con salida coloreada, indicadores de truncado y tablas
+- **Salida JSON** para consumo por agentes IA (`--json`)
+- **Configuracion persistente** en `~/.cli-anything/n8n/config.json`
+- **Manejo robusto de errores**: mensajes claros para errores HTTP, fallos de conexion, JSON invalido
+- **PEP 420 namespace packaging** — coexiste con otros harnesses de CLI-Anything
+
+### Inicio rapido
+
+```bash
+pip install cli-anything-n8n
+
+# Configurar
+export N8N_BASE_URL=https://tu-instancia-n8n.example.com
+export N8N_API_KEY=tu-api-key
+
+# Usar
+cli-anything-n8n workflow list
+cli-anything-n8n --json execution list --status error
+cli-anything-n8n tag create "produccion"
+```
+
+### Grupos de comandos
+
+| Grupo | Comandos | Endpoints API |
+|-------|----------|---------------|
+| `workflow` | list, get, create, update, delete, activate, deactivate, tags, set-tags, transfer | 9 |
+| `execution` | list, get, delete, retry | 4 |
+| `credential` | create, delete, schema, transfer | 4 |
+| `variable` | list, create, update, delete | 4 |
+| `tag` | list, get, create, update, delete | 5 |
+| `config` | show, set | - |
+
+> **Nota**: Algunas funcionalidades de n8n (Data Tables, listar credenciales, parar ejecuciones) no estan disponibles via la API publica. Este CLI solo expone endpoints verificados y funcionales.
+
+### Compatibilidad con n8n
+
+| Version n8n | Version API | Estado |
+|-------------|-------------|--------|
+| >= 1.0.0 | v1.1.1 | Verificado |
+| 2.43.0 | v1.1.1 | Testeado (E2E) |
+
+### Desarrollo
+
+```bash
+git clone https://github.com/webcomunicasolutions/cli-n8n.git
+cd cli-n8n
+pip install -e .
+pytest cli_anything/n8n/tests/test_core.py -v        # tests unitarios
+pytest cli_anything/n8n/tests/test_full_e2e.py -v     # E2E (requiere n8n corriendo)
+```
+
+### Licencia
+
+MIT

cli_anything_n8n-1.1.0/cli_anything/n8n/__init__.py

@@ -0,0 +1 @@
+# cli_anything.n8n — CLI harness for n8n workflow automation

cli_anything_n8n-1.1.0/cli_anything/n8n/__main__.py

@@ -0,0 +1,5 @@
+"""Enable python -m cli_anything.n8n"""
+from cli_anything.n8n.n8n_cli import main
+
+if __name__ == "__main__":
+    main()

cli_anything_n8n-1.1.0/cli_anything/n8n/core/credentials.py

@@ -0,0 +1,33 @@
+"""Credential management — create, delete, schema, transfer.
+
+Note: n8n Public API v1.1.1 does NOT support listing or updating credentials
+via GET/PATCH. This is by design — credentials contain sensitive data.
+Available operations: POST (create), DELETE, GET schema, PUT transfer.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from cli_anything.n8n.utils.n8n_backend import (
+    api_delete,
+    api_get,
+    api_post,
+    api_put,
+)
+
+
+def create_credential(data: dict[str, Any], *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_post("/credentials", data, base_url=base_url, api_key=api_key)
+
+
+def delete_credential(credential_id: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_delete(f"/credentials/{credential_id}", base_url=base_url, api_key=api_key)
+
+
+def get_credential_schema(credential_type: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_get(f"/credentials/schema/{credential_type}", base_url=base_url, api_key=api_key)
+
+
+def transfer_credential(credential_id: str, project_id: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_put(f"/credentials/{credential_id}/transfer", {"destinationProjectId": project_id}, base_url=base_url, api_key=api_key)

cli_anything_n8n-1.1.0/cli_anything/n8n/core/executions.py

@@ -0,0 +1,52 @@
+"""Execution management — list, get, delete, retry.
+
+Note: n8n Public API v1.1.1 does NOT support stop or tags on executions.
+Available: GET list, GET detail, DELETE, POST retry.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from cli_anything.n8n.utils.n8n_backend import (
+    api_delete,
+    api_get,
+    api_post,
+)
+
+
+def list_executions(
+    *,
+    base_url: str | None = None,
+    api_key: str | None = None,
+    status: str | None = None,
+    workflow_id: str | None = None,
+    limit: int = 20,
+    cursor: str | None = None,
+    include_data: bool = False,
+) -> Any:
+    params: dict[str, Any] = {"limit": limit}
+    if status:
+        params["status"] = status
+    if workflow_id:
+        params["workflowId"] = workflow_id
+    if cursor:
+        params["cursor"] = cursor
+    if include_data:
+        params["includeData"] = "true"
+    return api_get("/executions", base_url=base_url, api_key=api_key, params=params)
+
+
+def get_execution(execution_id: str, *, base_url: str | None = None, api_key: str | None = None, include_data: bool = True) -> Any:
+    params: dict[str, Any] = {}
+    if include_data:
+        params["includeData"] = "true"
+    return api_get(f"/executions/{execution_id}", base_url=base_url, api_key=api_key, params=params)
+
+
+def delete_execution(execution_id: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_delete(f"/executions/{execution_id}", base_url=base_url, api_key=api_key)
+
+
+def retry_execution(execution_id: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_post(f"/executions/{execution_id}/retry", base_url=base_url, api_key=api_key)

cli_anything_n8n-1.1.0/cli_anything/n8n/core/project.py

@@ -0,0 +1,49 @@
+"""Configuration management — load/save from JSON file + env vars."""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+from typing import Any
+
+
+CONFIG_DIR = Path.home() / ".cli-anything" / "n8n"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+DEFAULTS: dict[str, Any] = {
+    "base_url": "",
+    "api_key": "",
+}
+
+
+def load_config() -> dict[str, Any]:
+    """Load config from file, overlaid with env vars."""
+    cfg = dict(DEFAULTS)
+    if CONFIG_FILE.exists():
+        with open(CONFIG_FILE) as f:
+            cfg.update(json.load(f))
+    if url := os.environ.get("N8N_BASE_URL"):
+        cfg["base_url"] = url
+    if key := os.environ.get("N8N_API_KEY"):
+        cfg["api_key"] = key
+    return cfg
+
+
+def save_config(cfg: dict[str, Any]) -> Path:
+    """Persist config to disk."""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    with open(CONFIG_FILE, "w") as f:
+        json.dump(cfg, f, indent=2)
+    return CONFIG_FILE
+
+
+def get_connection(
+    base_url: str | None = None,
+    api_key: str | None = None,
+) -> tuple[str, str]:
+    """Resolve base_url and api_key from args > env > config file."""
+    cfg = load_config()
+    url = base_url or cfg["base_url"]
+    key = api_key or cfg["api_key"]
+    return url, key

cli_anything_n8n-1.1.0/cli_anything/n8n/core/tags.py

@@ -0,0 +1,32 @@
+"""Tag management — CRUD."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from cli_anything.n8n.utils.n8n_backend import (
+    api_delete,
+    api_get,
+    api_post,
+    api_put,
+)
+
+
+def list_tags(*, base_url: str | None = None, api_key: str | None = None, limit: int = 50) -> Any:
+    return api_get("/tags", base_url=base_url, api_key=api_key, params={"limit": limit})
+
+
+def get_tag(tag_id: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_get(f"/tags/{tag_id}", base_url=base_url, api_key=api_key)
+
+
+def create_tag(name: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_post("/tags", {"name": name}, base_url=base_url, api_key=api_key)
+
+
+def update_tag(tag_id: str, name: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_put(f"/tags/{tag_id}", {"name": name}, base_url=base_url, api_key=api_key)
+
+
+def delete_tag(tag_id: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_delete(f"/tags/{tag_id}", base_url=base_url, api_key=api_key)

cli_anything_n8n-1.1.0/cli_anything/n8n/core/variables.py

@@ -0,0 +1,28 @@
+"""Variable management — CRUD."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from cli_anything.n8n.utils.n8n_backend import (
+    api_delete,
+    api_get,
+    api_post,
+    api_put,
+)
+
+
+def list_variables(*, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_get("/variables", base_url=base_url, api_key=api_key)
+
+
+def create_variable(key: str, value: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_post("/variables", {"key": key, "value": value}, base_url=base_url, api_key=api_key)
+
+
+def update_variable(variable_id: str, key: str, value: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_put(f"/variables/{variable_id}", {"key": key, "value": value}, base_url=base_url, api_key=api_key)
+
+
+def delete_variable(variable_id: str, *, base_url: str | None = None, api_key: str | None = None) -> Any:
+    return api_delete(f"/variables/{variable_id}", base_url=base_url, api_key=api_key)