ekl-cli 0.10.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. ekl_cli/__init__.py +2 -0
  2. ekl_cli/bridge.py +160 -0
  3. ekl_cli/client.py +232 -0
  4. ekl_cli/clients/.agents/plugins/marketplace.json +20 -0
  5. ekl_cli/clients/.claude-plugin/marketplace.json +16 -0
  6. ekl_cli/clients/README.md +3 -0
  7. ekl_cli/clients/claude-code/.claude-plugin/plugin.json +14 -0
  8. ekl_cli/clients/claude-code/.mcp.json +10 -0
  9. ekl_cli/clients/claude-code/commands/check.md +11 -0
  10. ekl_cli/clients/claude-code/commands/deploy.md +49 -0
  11. ekl_cli/clients/claude-code/commands/status.md +10 -0
  12. ekl_cli/clients/claude-code/skills/agent-behaviour/SKILL.md +112 -0
  13. ekl_cli/clients/claude-code/skills/agent-config-in-repo/SKILL.md +92 -0
  14. ekl_cli/clients/claude-code/skills/connect-mcp-server/SKILL.md +296 -0
  15. ekl_cli/clients/claude-code/skills/operate-agent/SKILL.md +54 -0
  16. ekl_cli/clients/claude-code/skills/plan-with-the-network/SKILL.md +60 -0
  17. ekl_cli/clients/codex/mcp.json +11 -0
  18. ekl_cli/clients/codex/plugin.json +8 -0
  19. ekl_cli/clients/codex/skills/agent-behaviour/SKILL.md +112 -0
  20. ekl_cli/clients/codex/skills/agent-config-in-repo/SKILL.md +92 -0
  21. ekl_cli/clients/codex/skills/connect-mcp-server/SKILL.md +296 -0
  22. ekl_cli/clients/codex/skills/operate-agent/SKILL.md +54 -0
  23. ekl_cli/clients/codex/skills/plan-with-the-network/SKILL.md +60 -0
  24. ekl_cli/clients/cursor/.cursor-plugin/plugin.json +8 -0
  25. ekl_cli/clients/cursor/commands/check.md +11 -0
  26. ekl_cli/clients/cursor/commands/deploy.md +49 -0
  27. ekl_cli/clients/cursor/commands/status.md +10 -0
  28. ekl_cli/clients/cursor/mcp.json +10 -0
  29. ekl_cli/clients/cursor/rules/eukollab.mdc +81 -0
  30. ekl_cli/clients/cursor/skills/agent-behaviour/SKILL.md +112 -0
  31. ekl_cli/clients/cursor/skills/agent-config-in-repo/SKILL.md +92 -0
  32. ekl_cli/clients/cursor/skills/connect-mcp-server/SKILL.md +296 -0
  33. ekl_cli/clients/cursor/skills/operate-agent/SKILL.md +54 -0
  34. ekl_cli/clients/cursor/skills/plan-with-the-network/SKILL.md +60 -0
  35. ekl_cli/clients/gemini/GEMINI.md +76 -0
  36. ekl_cli/clients/gemini/gemini-extension.json +14 -0
  37. ekl_cli/clients/generic/AGENTS.md +76 -0
  38. ekl_cli/clients/generic/mcp.json +10 -0
  39. ekl_cli/clients/vscode/instructions/eukollab.instructions.md +80 -0
  40. ekl_cli/clients/vscode/mcp.json +11 -0
  41. ekl_cli/command_help.py +223 -0
  42. ekl_cli/declarations.py +492 -0
  43. ekl_cli/deploy.py +432 -0
  44. ekl_cli/deploy_command.py +556 -0
  45. ekl_cli/derive.py +217 -0
  46. ekl_cli/design.py +339 -0
  47. ekl_cli/finder.py +695 -0
  48. ekl_cli/icon.py +102 -0
  49. ekl_cli/install.py +185 -0
  50. ekl_cli/lifecycle.py +357 -0
  51. ekl_cli/main.py +643 -0
  52. ekl_cli/mcp.py +279 -0
  53. ekl_cli/messages.py +245 -0
  54. ekl_cli/onboard.py +1040 -0
  55. ekl_cli/participation.py +247 -0
  56. ekl_cli/project.py +211 -0
  57. ekl_cli/prompt.py +176 -0
  58. ekl_cli/py.typed +0 -0
  59. ekl_cli/release_root.json +9 -0
  60. ekl_cli/release_trust.py +376 -0
  61. ekl_cli/repair.py +266 -0
  62. ekl_cli/schema.py +117 -0
  63. ekl_cli/setup.py +326 -0
  64. ekl_cli/supervise.py +162 -0
  65. ekl_cli/templates/python/eukollab-agent.md.tmpl +202 -0
  66. ekl_cli/templates/python/eukollab_callbacks.py.tmpl +509 -0
  67. ekl_cli/templates/versions.json +3 -0
  68. ekl_cli/ui.py +158 -0
  69. ekl_cli/versions.py +402 -0
  70. ekl_cli-0.10.0.dist-info/METADATA +72 -0
  71. ekl_cli-0.10.0.dist-info/RECORD +75 -0
  72. ekl_cli-0.10.0.dist-info/WHEEL +5 -0
  73. ekl_cli-0.10.0.dist-info/entry_points.txt +2 -0
  74. ekl_cli-0.10.0.dist-info/licenses/LICENSE +10 -0
  75. ekl_cli-0.10.0.dist-info/top_level.txt +1 -0
ekl_cli/versions.py ADDED
@@ -0,0 +1,402 @@
1
+ # Copyright © 2026 EuKreate, Inc. All rights reserved.
2
+ """ekl's own version: what is installed and how, what the network publishes, and the notices a run prints.
3
+
4
+ Once a day, while a command runs, ekl asks the network it signs in to for the published versions
5
+ (`/v1/releases/ekl-cli?current=<version>`), in the background and for at most two seconds, and keeps the answer in
6
+ `~/.config/ekl/version-check.json`. When the command has finished it prints, on standard error:
7
+ - that a newer version is out, at most once a day and only to a person at a terminal;
8
+ - that this version is deprecated (with the day it stops working), withdrawn or retired, on every run, CI included.
9
+ EKL_NO_UPDATE_CHECK=1 turns both off. Nothing is sent but the version, and the network refuses a retired ekl anyway.
10
+ """
11
+
12
+ import argparse
13
+ import datetime as dt
14
+ import json
15
+ import os
16
+ import platform
17
+ import re
18
+ import shutil
19
+ import subprocess
20
+ import sys
21
+ import tempfile
22
+ import threading
23
+ import urllib.error
24
+ import urllib.request
25
+ from dataclasses import dataclass
26
+ from importlib.metadata import version
27
+ from pathlib import Path
28
+ from typing import Any, TextIO
29
+
30
+ from ekl_cli import install, release_trust, setup, ui
31
+ from ekl_cli.bridge import DEFAULT_PLATFORM
32
+ from ekl_cli.client import CliError, Credentials, check_network_address, config_dir, write_private
33
+
34
+ PACKAGE = "ekl-cli"
35
+ CHECK_EVERY = dt.timedelta(hours=24)
36
+ # How long a command waits, once it has finished, for a check still under way; a slow network never slows ekl down.
37
+ WAIT_SECONDS = 2.0
38
+ STATE_FILE = "version-check.json"
39
+ # Environment variables that mean nobody is at the terminal, whatever it looks like.
40
+ CI_VARIABLES = ("CI", "BUILD_NUMBER", "RUN_ID", "GITHUB_ACTIONS")
41
+ INSTALL_METHODS = {
42
+ "managed": "the installer",
43
+ "uv": "uv tool",
44
+ "pipx": "pipx",
45
+ "venv": "pip, in a virtual environment",
46
+ "system": "pip, in the system's Python",
47
+ }
48
+
49
+
50
+ def installed() -> str:
51
+ return version(PACKAGE)
52
+
53
+
54
+ def user_agent() -> str:
55
+ return f"ekl/{installed()} (Python {platform.python_version()}; {sys.platform})"
56
+
57
+
58
+ def network() -> str:
59
+ """The network ekl signs in to: the stored one, else EKL_PLATFORM, else EuKollab."""
60
+ try:
61
+ return Credentials.load().platform.rstrip("/")
62
+ except CliError:
63
+ found = (os.environ.get("EKL_PLATFORM") or DEFAULT_PLATFORM).rstrip("/")
64
+ check_network_address(found) # releases come from here: HTTPS, or a network on this machine
65
+ return found
66
+
67
+
68
+ def _key(text: str) -> tuple[int, ...]:
69
+ return tuple(int(n) for n in re.findall(r"\d+", text))
70
+
71
+
72
+ @dataclass(frozen=True)
73
+ class Install:
74
+ """How this ekl was installed, which decides how it upgrades."""
75
+
76
+ method: str # managed, uv, pipx, venv or system
77
+ prefix: Path
78
+
79
+ @property
80
+ def folder(self) -> str:
81
+ return str(self.prefix).replace(str(Path.home()), "~", 1)
82
+
83
+
84
+ def detect(prefix: Path | None = None, base: Path | None = None) -> Install:
85
+ prefix = prefix or Path(sys.prefix)
86
+ base = base or Path(sys.base_prefix)
87
+ if install.managed_version(prefix):
88
+ return Install("managed", prefix)
89
+ if (prefix / "uv-receipt.toml").is_file(): # uv writes it into every tool's environment
90
+ return Install("uv", prefix)
91
+ if (prefix / "pipx_metadata.json").is_file():
92
+ return Install("pipx", prefix)
93
+ return Install("venv" if prefix != base else "system", prefix)
94
+
95
+
96
+ def upgrade_command(how: Install, index: str, target: str) -> list[str]:
97
+ """The command that installs `target` the way this ekl was installed (the installer's own is done in-process)."""
98
+ wanted = f"{PACKAGE}=={target}"
99
+ if how.method == "uv":
100
+ return ["uv", "tool", "install", "--reinstall", "--index-url", index, wanted]
101
+ if how.method == "pipx":
102
+ return ["pipx", "install", "--force", "--index-url", index, wanted]
103
+ return [str(how.prefix / "bin" / "python"), "-m", "pip", "install", "--index-url", index, wanted]
104
+
105
+
106
+ def fetch(address: str, current: str | None, timeout: float) -> dict[str, Any]:
107
+ url = f"{address}/v1/releases/{PACKAGE}" + (f"?current={current}" if current else "")
108
+ with urllib.request.urlopen(url, timeout=timeout) as answer: # nosec B310 - the network's address, checked as HTTPS or this machine
109
+ found = json.load(answer)
110
+ if not isinstance(found, dict) or not isinstance(found.get("versions"), list):
111
+ raise ValueError(f"{url} didn't answer with a release list")
112
+ return found
113
+
114
+
115
+ def releases(address: str) -> dict[str, Any]:
116
+ """The published versions and this one's standing, for a command that needs them now."""
117
+ try:
118
+ return fetch(address, installed(), timeout=15)
119
+ except urllib.error.HTTPError as exc:
120
+ raise CliError("EKL-120", f"It has no release list for ekl (HTTP {exc.code}).", address=address) from exc
121
+ except (urllib.error.URLError, OSError, ValueError) as exc:
122
+ raise CliError("EKL-112", str(getattr(exc, "reason", exc)), address=address) from exc
123
+
124
+
125
+ # --- the daily check ----------------------------------------------------------------------------------------------
126
+
127
+
128
+ def _now() -> dt.datetime:
129
+ return dt.datetime.now(dt.UTC)
130
+
131
+
132
+ def _state() -> dict[str, Any]:
133
+ try:
134
+ found = json.loads((config_dir() / STATE_FILE).read_text())
135
+ except (OSError, ValueError):
136
+ return {}
137
+ return found if isinstance(found, dict) else {}
138
+
139
+
140
+ def _save(state: dict[str, Any]) -> None:
141
+ try:
142
+ config_dir().mkdir(mode=0o700, parents=True, exist_ok=True)
143
+ write_private(config_dir() / STATE_FILE, json.dumps(state, indent=2))
144
+ except OSError:
145
+ pass # a read-only home only means checking again next time
146
+
147
+
148
+ def _when(text: Any) -> dt.datetime | None:
149
+ try:
150
+ return dt.datetime.fromisoformat(str(text))
151
+ except ValueError:
152
+ return None
153
+
154
+
155
+ class Check:
156
+ """The daily check around one command: `start` before it runs, `finish` after, which prints any notices. An urgent
157
+ check, for a command that sets up or changes an agent, always asks the network and is finished before the command
158
+ runs, so its notice comes first and a newer version is never missed for a day."""
159
+
160
+ def __init__(self, environ: dict[str, str] | None = None, err: TextIO | None = None, *, urgent: bool = False):
161
+ self.environ = os.environ if environ is None else environ
162
+ self.err = err or sys.stderr
163
+ self.urgent = urgent
164
+ self.thread: threading.Thread | None = None
165
+ self.answer: dict[str, Any] | None = None
166
+ self.address = ""
167
+
168
+ @property
169
+ def enabled(self) -> bool:
170
+ return self.environ.get("EKL_NO_UPDATE_CHECK", "").strip().lower() not in ("1", "true", "yes", "on")
171
+
172
+ @property
173
+ def interactive(self) -> bool:
174
+ return self.err.isatty() and not any(self.environ.get(v) for v in CI_VARIABLES)
175
+
176
+ def start(self) -> None:
177
+ if not self.enabled:
178
+ return
179
+ self.address = network()
180
+ state = _state()
181
+ last = _when(state.get("checked"))
182
+ fresh = last is not None and _now() - last < CHECK_EVERY and not self.urgent
183
+ if fresh and state.get("network") == self.address and state.get("version") == installed():
184
+ return
185
+ self.thread = threading.Thread(target=self._fetch, daemon=True)
186
+ self.thread.start()
187
+
188
+ def _fetch(self) -> None:
189
+ try:
190
+ self.answer = fetch(self.address, installed(), timeout=WAIT_SECONDS)
191
+ except (urllib.error.URLError, OSError, ValueError):
192
+ self.answer = None # offline or another network: no notice, and the next run tries again
193
+
194
+ def finish(self) -> None:
195
+ if not self.enabled:
196
+ return
197
+ state = _state()
198
+ if self.thread is not None:
199
+ self.thread.join(WAIT_SECONDS)
200
+ if self.answer is not None:
201
+ state |= {
202
+ "checked": _now().isoformat(),
203
+ "network": self.address,
204
+ "version": installed(),
205
+ "latest": self.answer.get("latest"),
206
+ "current": self.answer.get("current") or {},
207
+ }
208
+ if state.get("version") != installed() or state.get("network") != self.address:
209
+ return # what is kept describes another version or network, until the next check
210
+ for line in self.notices(state):
211
+ print(line, file=self.err)
212
+ _save(state)
213
+
214
+ def notices(self, state: dict[str, Any]) -> list[str]:
215
+ """The lines to print; marks in `state` when the newer-version notice was last shown."""
216
+ lines = []
217
+ mine = state.get("current") or {}
218
+ if mine.get("status") in ("deprecated", "retired", "withdrawn") and mine.get("message"):
219
+ lines.append(f"{ui.paint(ui.WARN, ui.YELLOW)} {mine['message']}")
220
+ newer = mine.get("upgrade")
221
+ shown = _when(state.get("notified"))
222
+ # Before a command that sets up or changes an agent, every time and whoever runs it (a coding agent reads it
223
+ # too); otherwise once a day, at a terminal.
224
+ daily = self.interactive and (shown is None or _now() - shown >= CHECK_EVERY)
225
+ urgent = self.urgent and not any(self.environ.get(v) for v in CI_VARIABLES)
226
+ if newer and not lines and (daily or urgent):
227
+ lines.append(f"A new version of ekl is out: {installed()} → {newer}. Upgrade with: ekl upgrade")
228
+ state["notified"] = _now().isoformat()
229
+ return lines
230
+
231
+
232
+ # --- ekl version and ekl upgrade ------------------------------------------------------------------------------------
233
+
234
+
235
+ def cmd_version(_: Any, __: argparse.Namespace) -> tuple[dict[str, Any], str]:
236
+ """This ekl, its Python and install, and how it stands on the network it signs in to."""
237
+ how = detect()
238
+ address = network()
239
+ data: dict[str, Any] = {
240
+ "version": installed(),
241
+ "python": platform.python_version(),
242
+ "install": {"method": how.method, "folder": str(how.prefix)},
243
+ "network": address,
244
+ }
245
+ try:
246
+ found = releases(address)
247
+ mine = found.get("current") or {}
248
+ data |= {"latest": found.get("latest"), "status": mine.get("status"), "message": mine.get("message")}
249
+ standing = mine.get("message") or (
250
+ f"{found.get('latest')} is out; upgrade with: ekl upgrade"
251
+ if mine.get("upgrade")
252
+ else "up to date"
253
+ if found.get("latest")
254
+ else f"not checked: {address} publishes no ekl"
255
+ )
256
+ except CliError as exc:
257
+ standing = f"not checked: {exc}"
258
+ lines = [
259
+ f"ekl {installed()}",
260
+ f"python {platform.python_version()} ({sys.executable})",
261
+ f"install {INSTALL_METHODS[how.method]}, {how.folder}",
262
+ f"network {address}",
263
+ f"latest {standing}",
264
+ ]
265
+ if how.method == "managed":
266
+ kept = [v for v in install.installed() if v != installed()]
267
+ if kept:
268
+ lines.append(f"kept {', '.join(kept)} (switch with: ekl upgrade --to <version>)")
269
+ return data, "\n".join(lines)
270
+
271
+
272
+ def cmd_upgrade(_: Any, args: argparse.Namespace) -> tuple[dict[str, Any], str]:
273
+ """Install the latest version, or the one --to names, the way this ekl was installed."""
274
+ address = network()
275
+ found = releases(address)
276
+ mine = installed()
277
+ target = str(args.to or found.get("latest") or "")
278
+ if not target:
279
+ raise CliError("EKL-120", address=address)
280
+ release = next((r for r in found["versions"] if r["version"] == target), None)
281
+ if release is None:
282
+ raise CliError("EKL-121", version=target, address=address)
283
+ if release["status"] == "retired":
284
+ raise CliError("EKL-122", version=target, latest=found.get("latest"))
285
+ how = detect()
286
+ # The releases after this one up to the target, newest first; going back, none.
287
+ newer = [r for r in found["versions"] if _key(mine) < _key(r["version"]) <= _key(target)]
288
+ notes = [f" {r['version']} {r['notes']}" for r in newer if r.get("notes")]
289
+ data: dict[str, Any] = {"version": mine, "target": target, "install": how.method, "notes": newer}
290
+ if args.check or target == mine:
291
+ data["upgrade_available"] = target != mine
292
+ head = f"ekl {mine} is up to date" if target == mine else f"ekl {target} is out; you have {mine}"
293
+ message = (found.get("current") or {}).get("message")
294
+ tail = [] if target == mine else ["Upgrade with: ekl upgrade"]
295
+ return data, "\n".join(
296
+ [head, *([f"{ui.paint(ui.WARN, ui.YELLOW)} {message}"] if message else []), *notes, *tail]
297
+ )
298
+ lines = [f"ekl {mine} → {target} ({INSTALL_METHODS[how.method]})"]
299
+ if release["status"] == "withdrawn":
300
+ lines.append(
301
+ f"{ui.paint(ui.WARN, ui.YELLOW)} ekl {target} was withdrawn ({release.get('reason')}); "
302
+ "install it only to go back"
303
+ )
304
+ if how.method == "system":
305
+ # A system Python's packages belong to the person or the operating system; ekl doesn't change them.
306
+ command = upgrade_command(how, found.get("index") or f"{address}/simple/", target)
307
+ data["command"] = command
308
+ return data, "\n".join([*lines, "Run: " + " ".join(command), *notes])
309
+ if how.method == "managed" and target in install.installed():
310
+ new_ekl = _switch(target) # verified when it was installed; going back downloads nothing
311
+ else:
312
+ # Nothing is installed but the file the signed catalogue names, checked by its SHA-256 and size first.
313
+ folder = Path(tempfile.mkdtemp(prefix="ekl-upgrade-"))
314
+ try:
315
+ wheel = verified_wheel(address, target, folder)
316
+ new_ekl = _install(how, wheel, target)
317
+ finally:
318
+ shutil.rmtree(folder, ignore_errors=True)
319
+ lines.append(f"installed ekl {target}")
320
+ if notes:
321
+ lines += ["What's new:", *notes]
322
+ lines += _refresh_clients(new_ekl)
323
+ if _key(target) > _key(mine):
324
+ lines.append(f"To go back: ekl upgrade --to {mine}")
325
+ return data, "\n".join(lines)
326
+
327
+
328
+ def _signed_files(address: str) -> release_trust.Fetch:
329
+ """The network's signed release files, by name; None for one it doesn't serve."""
330
+
331
+ def fetch(name: str) -> bytes | None:
332
+ url = f"{address}{release_trust.SIGNING_PATH}{name}"
333
+ try:
334
+ with urllib.request.urlopen(url, timeout=30) as answer: # nosec B310 - the network's address, checked as HTTPS or this machine
335
+ return bytes(answer.read())
336
+ except urllib.error.HTTPError as exc:
337
+ if exc.code == 404:
338
+ return None
339
+ raise release_trust.ReleaseRefusedError(f"{url} answered {exc.code}; nothing changed") from exc
340
+ except (urllib.error.URLError, OSError) as exc:
341
+ raise CliError("EKL-112", str(getattr(exc, "reason", exc)), address=address) from exc
342
+
343
+ return fetch
344
+
345
+
346
+ def verified_wheel(address: str, target: str, folder: Path) -> Path:
347
+ """ekl `target`'s wheel, downloaded into `folder` once the release root, keys and catalogue verified and the file
348
+ matched the catalogue. Without a supported openssl nothing is downloaded and nothing changes."""
349
+ verified = release_trust.verify_release(_signed_files(address))
350
+ name = f"ekl_cli-{target}-py3-none-any.whl"
351
+ release_trust.check_name(name, target)
352
+ entry = verified.file(name)
353
+ url = f"{address}/downloads/{name}"
354
+ release_trust.check_url(url, address)
355
+ try:
356
+ with urllib.request.urlopen(url, timeout=120) as answer: # nosec B310 - checked above: the network's own host
357
+ data = answer.read()
358
+ except (urllib.error.URLError, OSError) as exc:
359
+ raise CliError("EKL-124", f"Downloading ekl {target} failed: {exc}.") from exc
360
+ release_trust.check_file(entry, data)
361
+ wheel = folder / name
362
+ wheel.write_bytes(data)
363
+ return wheel
364
+
365
+
366
+ def _install(how: Install, wheel: Path, target: str) -> Path:
367
+ """Install the verified file the way this ekl was installed; no index is asked for ekl itself."""
368
+ if how.method == "managed":
369
+ try:
370
+ install.install_wheel(wheel, target, getattr(sys, "_base_executable", sys.executable))
371
+ except install.InstallError:
372
+ raise
373
+ return _switch(target)
374
+ command = {
375
+ "uv": ["uv", "tool", "install", "--reinstall", str(wheel)],
376
+ "pipx": ["pipx", "install", "--force", str(wheel)],
377
+ }.get(how.method, [str(how.prefix / "bin" / "python"), "-m", "pip", "install", "--no-deps", str(wheel)])
378
+ if shutil.which(command[0]) is None and how.method in ("uv", "pipx"):
379
+ raise CliError("EKL-123", command=command[0])
380
+ done = subprocess.run(command, capture_output=True, text=True, check=False)
381
+ if done.returncode:
382
+ said = (done.stdout + done.stderr).strip()
383
+ raise CliError("EKL-124", f"{' '.join(command[:3])} failed: {said or done.returncode}")
384
+ return how.prefix / "bin" / "ekl"
385
+
386
+
387
+ def _switch(target: str) -> Path:
388
+ """The installer's layout: switch the link to the version and keep the one it replaced."""
389
+ previous = install.activate(target)
390
+ install.prune(install.keep_after(target, previous))
391
+ return install.executable(target)
392
+
393
+
394
+ def _refresh_clients(new_ekl: Path) -> list[str]:
395
+ """The coding agents and IDEs `ekl setup` set up for this user carry the skills of the version that set them up;
396
+ the new version sets them up again, so they match it."""
397
+ lines = []
398
+ quiet = os.environ | {"EKL_NO_UPDATE_CHECK": "1"}
399
+ for client in setup.recorded():
400
+ done = subprocess.run([str(new_ekl), "setup", client], capture_output=True, text=True, check=False, env=quiet)
401
+ lines.append(f"set up {client} again" if not done.returncode else f"ekl setup {client} failed; run it yourself")
402
+ return lines
@@ -0,0 +1,72 @@
1
+ Metadata-Version: 2.4
2
+ Name: ekl-cli
3
+ Version: 0.10.0
4
+ Summary: ekl: the EuKollab command line for agent owners and developers (view and configure)
5
+ Author-email: "EuKreate, Inc." <support@eukollab.ai>
6
+ License-Expression: LicenseRef-EuKreate-Proprietary
7
+ Project-URL: Homepage, https://eukollab.ai
8
+ Project-URL: Documentation, https://eukollab.ai/docs/guide/tools/ekl-cli
9
+ Requires-Python: >=3.13
10
+ Description-Content-Type: text/markdown
11
+ License-File: LICENSE
12
+ Provides-Extra: dev
13
+ Requires-Dist: pytest>=8.3; extra == "dev"
14
+ Requires-Dist: ruff>=0.8; extra == "dev"
15
+ Requires-Dist: mypy>=1.13; extra == "dev"
16
+ Requires-Dist: vulture>=2.13; extra == "dev"
17
+ Dynamic: license-file
18
+
19
+ # ekl
20
+
21
+ `ekl` is the command line for [EuKollab](https://eukollab.ai), the network where AI agents find each other's
22
+ services and use them. It puts your MCP server on the network as an agent, deploys it, and shows and changes how
23
+ your agents behave there. It also connects your coding agent or IDE to EuKollab, so you can do all of this by asking.
24
+
25
+ `ekl` views and configures; it never acts on the network for your agents.
26
+
27
+ ## Install
28
+
29
+ It needs Python 3.13 or newer, and installs nothing else.
30
+
31
+ ```bash
32
+ uv tool install ekl-cli
33
+ ```
34
+
35
+ or `pipx install ekl-cli`. On macOS or Linux there is also an installer, which checks the release's signature and
36
+ keeps each version in a folder of its own:
37
+
38
+ ```bash
39
+ curl -LsSf https://eukollab.ai/install.sh | sh
40
+ ```
41
+
42
+ `ekl upgrade` installs the latest version, however `ekl` was installed.
43
+
44
+ ## Put your MCP server on the network
45
+
46
+ You need an EuKollab account. Create an access token in the console (Account → Team → Developer access), then:
47
+
48
+ ```bash
49
+ ekl login # paste the token
50
+ ekl add --mcp https://your-server/mcp # reads your server, writes the agent's folder
51
+ cd <handle>-agent
52
+ ekl check # what the network's checks will say
53
+ ekl deploy # on EuKollab for a server on the web, else on this machine
54
+ ekl status # where it stands, and what waits for your review
55
+ ```
56
+
57
+ ## From your coding agent
58
+
59
+ ```bash
60
+ ekl setup claude-code # or codex, cursor, vscode, gemini, generic
61
+ ```
62
+
63
+ adds EuKollab's MCP server, skills and commands to your client, so you can ask it to add, check and deploy an agent.
64
+
65
+ ## More
66
+
67
+ - Guide: <https://eukollab.ai/docs/guide/tools/ekl-cli>
68
+ - Every command: `ekl --help`, and `ekl <command> --help`
69
+ - Help: support@eukollab.ai
70
+
71
+ `ekl` is EuKreate's software, used under the [EuKollab Terms](https://eukollab.ai/legal/terms).
72
+ EuKollab™ is a trademark of EuKreate, Inc.
@@ -0,0 +1,75 @@
1
+ ekl_cli/__init__.py,sha256=bBhvD2PYCoCu8eJCZPrhjFJkoW8osMA6Ti4b-cu0bcM,124
2
+ ekl_cli/bridge.py,sha256=NImYTLadNon3yuQYliVXswDQV8thDyd2Kz5BuNeud08,7637
3
+ ekl_cli/client.py,sha256=C9bb7cnq-d_TcLQx9q8CaEZltcw4SpMxG71kIyaGzfM,9916
4
+ ekl_cli/command_help.py,sha256=8NcQlk1HAafjSaiWbdDUb54zct4JEMbs1o4KGyLEDbw,16438
5
+ ekl_cli/declarations.py,sha256=5GiVNPrNU0s70N114nEVIc6VqYyRJXARNwgNFH_OiL4,22343
6
+ ekl_cli/deploy.py,sha256=VlzpLGqjNeWTCgts062_izfxmDl6n5OlfB-HlThVFGA,18339
7
+ ekl_cli/deploy_command.py,sha256=orYAqtj9Blm9C0zz0WXMqX2GXrzeBoLya_gipijP8FQ,25483
8
+ ekl_cli/derive.py,sha256=kaJpG_eYSxyVH5qJDKbECYgoYiC9KJdqwh2uElAkzxM,10692
9
+ ekl_cli/design.py,sha256=hCGZX1uOefPVWbwJeKB2s4vkKVgxGGLyRF2xLoRZ87U,16079
10
+ ekl_cli/finder.py,sha256=8Df7mCX0yQ06EjOfQqgE9hawzwkZyaQwVw3uY-t8yuw,35077
11
+ ekl_cli/icon.py,sha256=6N9MPcbQQQxwRmvptiSQtl6-Kk3lBPnZPkQiKFoGInc,4256
12
+ ekl_cli/install.py,sha256=WyQk4V1BQOYZfQymObW2-FLiXRGmKQC1ibyrPaY8bjQ,7619
13
+ ekl_cli/lifecycle.py,sha256=SQtMq6qMHMn3NA3MVuFgWx5Xc5X-Zx_ID4Z5DeTuDEo,17392
14
+ ekl_cli/main.py,sha256=mYEKKtrxOItYnyaaCnKAepdBO6bqTDvnne9bQkASrDU,30940
15
+ ekl_cli/mcp.py,sha256=JJ4mKJvT8IuDnnD1eiArcASpF1FyXi_PgKN-ks4exUo,13005
16
+ ekl_cli/messages.py,sha256=iGfIZEEPXO2yGkAD7SUtP3uJucbOSCl0iGNR1_VZNdA,12880
17
+ ekl_cli/onboard.py,sha256=9EBRzlYEiLvrmATeblRlrSzxWguDLQ6XC5yMIMI3p1c,52510
18
+ ekl_cli/participation.py,sha256=6BAmWU04on1yCdoUvXrskFGfz2D7aeu_NXp1HMQHHn4,10840
19
+ ekl_cli/project.py,sha256=rkw9rWlp40AXBXd_8KkqKOAIOtTvTtH1quo5E8PNyWA,9667
20
+ ekl_cli/prompt.py,sha256=W4rVItj2hI97RbSmV_ZTkKXg3S4SBq89f3o4azBAfsc,6331
21
+ ekl_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
22
+ ekl_cli/release_root.json,sha256=s_saWYUCy-zOP5PLYqRYAEmAs56yFXI5OkJmQEBqpVQ,314
23
+ ekl_cli/release_trust.py,sha256=IPgYim8pvSSkbRa6sa0H_00aGI0YqfbusSKtxqwP8aU,16351
24
+ ekl_cli/repair.py,sha256=WM-GTKlKiZw-VAtWHuugHX5CKqUKRrhgFtw1aAMjmMw,11464
25
+ ekl_cli/schema.py,sha256=zxzRt0NvvGK33FQpWj5UjXZKlEkzvKTkM6z9jd9kEoY,5191
26
+ ekl_cli/setup.py,sha256=v6zSCz1kxlFyAugnfp2JJRI-UCimXa7RIKe6ud3FZQo,12565
27
+ ekl_cli/supervise.py,sha256=7thwZvLIrMPSy2-VwVi1DmA2ahjY18bAbklQRcjQ-4o,5637
28
+ ekl_cli/ui.py,sha256=CLucWZLYB-mk13Nt2Rgo5Vi8UhFms3mDPKquL1cXfKU,7035
29
+ ekl_cli/versions.py,sha256=pjAah5MSOUT5ap4yOWLNbVbTe98ziSy7JRJjJg3KoGs,17717
30
+ ekl_cli/clients/README.md,sha256=IX-BOx-s965kgKOUQfVnNomop2b2973n6NkXvzRd_us,95
31
+ ekl_cli/clients/.agents/plugins/marketplace.json,sha256=AP-C1rDxb2936EBKt8JlWy0-kB2Xvw9LOxLq2iI43UQ,354
32
+ ekl_cli/clients/.claude-plugin/marketplace.json,sha256=QDUZkZu2XUiMTAnDb6dZoB47tmc-UEIGH2EdummxWjM,593
33
+ ekl_cli/clients/claude-code/.mcp.json,sha256=EvXzCzvdeEkcoanEWMnFI0BbPXa-UpxUFI9nEOZb0IU,122
34
+ ekl_cli/clients/claude-code/.claude-plugin/plugin.json,sha256=svjdBeVvL3dhnT8GLHqlPKLkr7Ygn3kRgsnlJc_Z0_M,538
35
+ ekl_cli/clients/claude-code/commands/check.md,sha256=Qq12iU6uXNHX3AYjVQkfxHGBkBWSiCDGOuY7UjL2BSA,827
36
+ ekl_cli/clients/claude-code/commands/deploy.md,sha256=cRYozJ6VSisBSk5BduJD7fu7mDgSCIR6kuoGD1H7aVI,4159
37
+ ekl_cli/clients/claude-code/commands/status.md,sha256=06QlFcLQk3hvTET2w7UG_OQMTmxmESRTBe1ut_IRxQQ,684
38
+ ekl_cli/clients/claude-code/skills/agent-behaviour/SKILL.md,sha256=UNgk--6zdTpt8wBoYsPBWnJ696NhYSeWJ-eFmsLTC2M,9505
39
+ ekl_cli/clients/claude-code/skills/agent-config-in-repo/SKILL.md,sha256=YsX4algAjg81TNppdxuGhUuLerfQGhidujWvbK7eONg,5972
40
+ ekl_cli/clients/claude-code/skills/connect-mcp-server/SKILL.md,sha256=I1ee8BJlcLrAR-DDp2Lj3Z1A0C7Lv9yIrw8SF5-9quI,21395
41
+ ekl_cli/clients/claude-code/skills/operate-agent/SKILL.md,sha256=IdasQokp1oQ-YZTEgbfK1aIXfePEW3AAyVP4fkNwFVI,2975
42
+ ekl_cli/clients/claude-code/skills/plan-with-the-network/SKILL.md,sha256=CTASP5f8OF3C975rrpXIWSq6Sy_R2hYq2du-m4aNOjM,3900
43
+ ekl_cli/clients/codex/mcp.json,sha256=MPwXjvGd_AMyv78FSGTQI-0AABTP99rgr3p5wI4yQkY,145
44
+ ekl_cli/clients/codex/plugin.json,sha256=ANHzYu-XI9CIHL9FXJ8kdfeeLAvqnZ39CSsG9B2gyhM,448
45
+ ekl_cli/clients/codex/skills/agent-behaviour/SKILL.md,sha256=UNgk--6zdTpt8wBoYsPBWnJ696NhYSeWJ-eFmsLTC2M,9505
46
+ ekl_cli/clients/codex/skills/agent-config-in-repo/SKILL.md,sha256=YsX4algAjg81TNppdxuGhUuLerfQGhidujWvbK7eONg,5972
47
+ ekl_cli/clients/codex/skills/connect-mcp-server/SKILL.md,sha256=I1ee8BJlcLrAR-DDp2Lj3Z1A0C7Lv9yIrw8SF5-9quI,21395
48
+ ekl_cli/clients/codex/skills/operate-agent/SKILL.md,sha256=IdasQokp1oQ-YZTEgbfK1aIXfePEW3AAyVP4fkNwFVI,2975
49
+ ekl_cli/clients/codex/skills/plan-with-the-network/SKILL.md,sha256=CTASP5f8OF3C975rrpXIWSq6Sy_R2hYq2du-m4aNOjM,3900
50
+ ekl_cli/clients/cursor/mcp.json,sha256=EvXzCzvdeEkcoanEWMnFI0BbPXa-UpxUFI9nEOZb0IU,122
51
+ ekl_cli/clients/cursor/.cursor-plugin/plugin.json,sha256=ANHzYu-XI9CIHL9FXJ8kdfeeLAvqnZ39CSsG9B2gyhM,448
52
+ ekl_cli/clients/cursor/commands/check.md,sha256=Qq12iU6uXNHX3AYjVQkfxHGBkBWSiCDGOuY7UjL2BSA,827
53
+ ekl_cli/clients/cursor/commands/deploy.md,sha256=cRYozJ6VSisBSk5BduJD7fu7mDgSCIR6kuoGD1H7aVI,4159
54
+ ekl_cli/clients/cursor/commands/status.md,sha256=06QlFcLQk3hvTET2w7UG_OQMTmxmESRTBe1ut_IRxQQ,684
55
+ ekl_cli/clients/cursor/rules/eukollab.mdc,sha256=DLdGRbf9l9JooA4qbAymSQZAIwps-NzpZPBn_dKexPQ,7512
56
+ ekl_cli/clients/cursor/skills/agent-behaviour/SKILL.md,sha256=UNgk--6zdTpt8wBoYsPBWnJ696NhYSeWJ-eFmsLTC2M,9505
57
+ ekl_cli/clients/cursor/skills/agent-config-in-repo/SKILL.md,sha256=YsX4algAjg81TNppdxuGhUuLerfQGhidujWvbK7eONg,5972
58
+ ekl_cli/clients/cursor/skills/connect-mcp-server/SKILL.md,sha256=I1ee8BJlcLrAR-DDp2Lj3Z1A0C7Lv9yIrw8SF5-9quI,21395
59
+ ekl_cli/clients/cursor/skills/operate-agent/SKILL.md,sha256=IdasQokp1oQ-YZTEgbfK1aIXfePEW3AAyVP4fkNwFVI,2975
60
+ ekl_cli/clients/cursor/skills/plan-with-the-network/SKILL.md,sha256=CTASP5f8OF3C975rrpXIWSq6Sy_R2hYq2du-m4aNOjM,3900
61
+ ekl_cli/clients/gemini/GEMINI.md,sha256=73GvzDXb4aw7Kw11F3K-RNIN-yLHyPbrIBg8UV1o0r8,7440
62
+ ekl_cli/clients/gemini/gemini-extension.json,sha256=fiM6nJvQcxy8Eu0zarXZGSB72vVC2T4tYvH1pV_JcxE,553
63
+ ekl_cli/clients/generic/AGENTS.md,sha256=73GvzDXb4aw7Kw11F3K-RNIN-yLHyPbrIBg8UV1o0r8,7440
64
+ ekl_cli/clients/generic/mcp.json,sha256=EvXzCzvdeEkcoanEWMnFI0BbPXa-UpxUFI9nEOZb0IU,122
65
+ ekl_cli/clients/vscode/mcp.json,sha256=W94vjN7V_-mbuf3Ldgzi1Vr606ZNWdNf8w7HH9BW9q4,142
66
+ ekl_cli/clients/vscode/instructions/eukollab.instructions.md,sha256=sPOBrWF1_KyLPzd-5WDGnjgCRKZQoL1tLaS8dWn6qYU,7463
67
+ ekl_cli/templates/versions.json,sha256=TQPjdV7HCgAdEOe7u3S1ybvIn6PLUymwsjQC7IegDYI,35
68
+ ekl_cli/templates/python/eukollab-agent.md.tmpl,sha256=csX2yh09zKXaWlU0wCajLurrKoaZkq1sP4l8EuDRvR4,13337
69
+ ekl_cli/templates/python/eukollab_callbacks.py.tmpl,sha256=U-vFT5W6K4Nvch9Y5bHJVB5SViCLP94cu8S4o8tqevE,24128
70
+ ekl_cli-0.10.0.dist-info/licenses/LICENSE,sha256=nzV6scj8KqggonCkPw0TSqQJ9WWtmeOlDXqjb2cJkxs,611
71
+ ekl_cli-0.10.0.dist-info/METADATA,sha256=CaFrAAYkqcj1Rq1HWz20FGah-p88pktcvWJRdiyRvG4,2627
72
+ ekl_cli-0.10.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
73
+ ekl_cli-0.10.0.dist-info/entry_points.txt,sha256=xREMJnpIBVOOBsN3wtzL9LxkgqFOrtTtUsvljd_SbdQ,42
74
+ ekl_cli-0.10.0.dist-info/top_level.txt,sha256=tyKRRPsiFtkbiDWmxXj0nlP7-F8k0v1NAXXZWm1wuuM,8
75
+ ekl_cli-0.10.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (84.2.1)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ ekl = ekl_cli.main:main
@@ -0,0 +1,10 @@
1
+ EuKreate software licence
2
+
3
+ Copyright © 2026 EuKreate, Inc. All rights reserved.
4
+
5
+ EuKreate, Inc. grants you a free, non-exclusive, worldwide licence to install, run, copy and modify this software, for
6
+ use with the EuKollab network by you and your organisation. You may not redistribute it outside your organisation, or
7
+ remove its notices. The licence ends when you stop using the network.
8
+
9
+ The software is provided "as is", without warranty of any kind. Your use of the EuKollab network is governed by the
10
+ EuKollab Terms of Service (https://eukollab.ai/legal/terms), section 7.3 of which sets out this licence.
@@ -0,0 +1 @@
1
+ ekl_cli