ellf-cli 7.0.0__tar.gz → 10.0.1__tar.gz

{ellf_cli-7.0.0/ellf_cli.egg-info → ellf_cli-10.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ellf-cli
-Version: 7.0.0
+Version: 10.0.1
 Summary: Ellf Command Line Interface
 Home-page: https://prodi.gy
 Author: ExplosionAI GmbH

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/about.json

@@ -1,7 +1,7 @@
 {
   "title": "Ellf CLI",
   "name": "ellf-cli",
-  "version": "7.0.0",
+  "version": "10.0.1",
   "summary": "Ellf Command Line Interface",
   "uri": "https://prodi.gy",
   "prog": "ellf",

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/commands/general.py

@@ -128,11 +128,23 @@ def login(
         # below run against the chosen org's api_token, not whatever org
         # the device-flow login happened to land in.
         _select_and_persist_org(auth, org)
+    if claude:
+        # Claude setup needs only the packaged skill assets and the
+        # ellf-core token minted by the device flow above — not the
+        # cluster. Run it before cluster selection so cluster failures
+        # (token mint errors, unreachable broker, no cluster registered)
+        # can't block skill installation.
+        _install_claude_skills()
+        _configure_claude_mcp(auth)
     if not no_cluster:
         try:
             _select_and_persist_cluster(auth, cluster)
             auth.get_cluster_token(force_refresh=True)
-        except EllfError as e:
+        except (EllfError, CLIError, httpx.HTTPError) as e:
+            # httpx transport errors (broker unreachable) and CLIError
+            # (no cluster registered, --cluster not matched) are just as
+            # common as EllfError token failures; all of them should get
+            # the --no-cluster hint instead of a raw traceback.
             err = Messages.E116.format(command=f"{cli.prog} login --no-cluster")
             raise CLIError(err, e)
     print_mutation_result(
@@ -140,9 +152,6 @@ def login(
         Messages.T012,
         as_json=as_json,
     )
-    if claude:
-        _install_claude_skills()
-        _configure_claude_mcp(auth)
 
 
 @cli.command(

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/ellf.json

@@ -1,7 +1,7 @@
 {
   "prog": "ellf",
   "help": "Ellf Command Line Interface.",
-  "version": "6.1.12",
+  "version": "6.1.5",
   "extra_key": "_extra",
   "commands": {
     "actions": {
@@ -275,7 +275,7 @@
           "orig_type": "bool"
         }
       ],
-      "description": "\n    Log in to your Ellf account. You normally don't need to call this\n    manually. It will automatically authenticate when needed.\n    ",
+      "description": "\nLog in to your Ellf account. You normally don't need to call this\nmanually. It will automatically authenticate when needed.\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -310,7 +310,7 @@
           "orig_type": "bool"
         }
       ],
-      "description": "\n    Log out by deleting locally-stored auth tokens.\n\n    PAM bearer tokens can't be revoked server-side, so this is a local\n    operation: subsequent commands will trigger a fresh device-flow\n    login. The cached tokens would have expired on their own within\n    roughly an hour. Use ``--all`` to also reset the saved defaults\n    (active org, cluster, project, etc.), e.g. when handing the\n    machine to a different user.\n    ",
+      "description": "\nLog out by deleting locally-stored auth tokens.\n\nPAM bearer tokens can't be revoked server-side, so this is a local\noperation: subsequent commands will trigger a fresh device-flow\nlogin. The cached tokens would have expired on their own within\nroughly an hour. Use ``--all`` to also reset the saved defaults\n(active org, cluster, project, etc.), e.g. when handing the\nmachine to a different user.\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -356,15 +356,14 @@
             "api",
             "cluster",
             "id",
-            "ci",
-            "ellf-core"
+            "ci"
           ],
           "has_converter": false,
           "type": "str",
-          "orig_type": "Literal[api, cluster, id, ci, ellf-core]"
+          "orig_type": "Literal[api, cluster, id, ci]"
         }
       ],
-      "description": "\n    Return an auth token for the current user\n    ",
+      "description": "\nReturn an auth token for the current user\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -440,7 +439,7 @@
           "orig_type": "list[Literal[tasks, actions, assets, datasets, paths]]"
         }
       ],
-      "description": "\n    Save the state of the current app JSON file. If an assets directory is\n    provided, assets will be downloaded and referenced in the JSON accordingly.\n    ",
+      "description": "\nSave the state of the current app JSON file. If an assets directory is\nprovided, assets will be downloaded and referenced in the JSON accordingly.\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -475,7 +474,7 @@
           "orig_type": "bool"
         }
       ],
-      "description": "\n    Populate Ellf with data for projects, tasks, actions, assets and paths.\n    ",
+      "description": "\nPopulate Ellf with data for projects, tasks, actions, assets and paths.\n",
       "allow_extra": false,
       "parent": null,
       "is_placeholder": false
@@ -565,7 +564,7 @@
             "orig_type": "List[str]"
           }
         ],
-        "description": "\n    Create a new action. The available action recipes are fetched from your\n    cluster and are added as dynamic subcommands. You can see more details\n    and available arguments by calling the subcommand with --help, e.g. create\n    [name] --help\n    ",
+        "description": "\nCreate a new action. The available action recipes are fetched from your\ncluster and are added as dynamic subcommands. You can see more details\nand available arguments by calling the subcommand with --help, e.g. create\n[name] --help\n",
         "allow_extra": true,
         "parent": "actions",
         "is_placeholder": false
@@ -600,7 +599,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    List the actions on the cluster. By default, this includes their ID, name\n    and current state, e.g. created or completed\n    ",
+        "description": "\nList the actions on the cluster. By default, this includes their ID, name\nand current state, e.g. created or completed\n",
         "allow_extra": false,
         "parent": "actions",
         "is_placeholder": false
@@ -1059,7 +1058,7 @@
             "orig_type": "List[str]"
           }
         ],
-        "description": "\n    Create a new agent. The available agent recipes are fetched from your\n    cluster and are added as dynamic subcommands. You can see more details\n    and available arguments by calling the subcommand with --help, e.g. create\n    [name] --help\n    ",
+        "description": "\nCreate a new agent. The available agent recipes are fetched from your\ncluster and are added as dynamic subcommands. You can see more details\nand available arguments by calling the subcommand with --help, e.g. create\n[name] --help\n",
         "allow_extra": true,
         "parent": "agents",
         "is_placeholder": false
@@ -1168,7 +1167,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    List the agents on the cluster. By default, this includes their ID, name\n    and current state, e.g. created or completed\n    ",
+        "description": "\nList the agents on the cluster. By default, this includes their ID, name\nand current state, e.g. created or completed\n",
         "allow_extra": false,
         "parent": "agents",
         "is_placeholder": false
@@ -1662,7 +1661,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Get detailed info for an asset uploaded to the cluster and registered\n    with Ellf\n    ",
+        "description": "\nGet detailed info for an asset uploaded to the cluster and registered\nwith Ellf\n",
         "allow_extra": false,
         "parent": "assets",
         "is_placeholder": false
@@ -1762,7 +1761,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Create an asset on the cluster and register it with Ellf. Assets\n    point to files or directories you control. The Ellf server only has\n    a reference to them. This command doesn't transfer any data. See `ellf files`\n    for utilities to transfer files to and from your cluster\n    ",
+        "description": "\nCreate an asset on the cluster and register it with Ellf. Assets\npoint to files or directories you control. The Ellf server only has\na reference to them. This command doesn't transfer any data. See `ellf files`\nfor utilities to transfer files to and from your cluster\n",
         "allow_extra": false,
         "parent": "assets",
         "is_placeholder": false
@@ -1833,7 +1832,7 @@
       "import": {
         "name": "import",
         "args": [],
-        "description": "Read a serialised FileSecrets blob from stdin and write it to\n    the local secrets file.\n\n    Counterpart to ``ellf auth push``. Existing local auth state is\n    overwritten; the file is written 0600 by FileSecrets.save.\n    ",
+        "description": "Read a serialised FileSecrets blob from stdin and write it to\nthe local secrets file.\n\nCounterpart to ``ellf auth push``. Existing local auth state is\noverwritten; the file is written 0600 by FileSecrets.save.\n",
         "allow_extra": false,
         "parent": "auth",
         "is_placeholder": false
@@ -1868,7 +1867,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Push local auth state to a remote machine via SSH.\n\n    Reads the local FileSecrets, JSON-serialises it, and pipes it to\n    ``<remote_ellf> auth import`` over an SSH connection to *host*.\n    Authentication is delegated to ssh \u2014 anything in your ssh config\n    (host aliases, ProxyJump, key-based auth) just works.\n\n    The pushed blob includes id_token, api_token, and any cached\n    broker_tokens. id_token expiry is dictated by the issuer (typically\n    ~1h), so this is a \"give the remote a usable session\" operation,\n    not a permanent provisioning. Re-run when the token expires.\n    ",
+        "description": "Push local auth state to a remote machine via SSH.\n\nReads the local FileSecrets, JSON-serialises it, and pipes it to\n``<remote_ellf> auth import`` over an SSH connection to *host*.\nAuthentication is delegated to ssh \u2014 anything in your ssh config\n(host aliases, ProxyJump, key-based auth) just works.\n\nThe pushed blob includes id_token, api_token, and any cached\nbroker_tokens. id_token expiry is dictated by the issuer (typically\n~1h), so this is a \"give the remote a usable session\" operation,\nnot a permanent provisioning. Re-run when the token expires.\n",
         "allow_extra": false,
         "parent": "auth",
         "is_placeholder": false
@@ -1940,7 +1939,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Switch the active cluster.\n\n    Looks up the cluster by name or ID via PAM. With no argument and\n    multiple clusters available, prompts interactively in a TTY.\n    ",
+        "description": "Switch the active cluster.\n\nLooks up the cluster by name or ID via PAM. With no argument and\nmultiple clusters available, prompts interactively in a TTY.\n",
         "allow_extra": false,
         "parent": "clusters",
         "is_placeholder": false
@@ -2084,7 +2083,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Delete a cluster from PAM. This only removes PAM's record\n    of it. The cluster itself will continue to exist - you need\n    to shut it down separately.\n    ",
+        "description": "\nDelete a cluster from PAM. This only removes PAM's record\nof it. The cluster itself will continue to exist - you need\nto shut it down separately.\n",
         "allow_extra": false,
         "parent": "clusters",
         "is_placeholder": false
@@ -2184,7 +2183,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Check the health of a cluster deployment.\n\n    Runs CLI-side connectivity checks against the cluster and PAM.\n    Use --deep (or supply --s3-bucket / --nfs-path / --recipe) to also\n    trigger cluster-side deployment checks via the broker's /v1/check\n    endpoints (K8s API, NFS, S3, recipe execution, DB).\n    ",
+        "description": "Check the health of a cluster deployment.\n\nRuns CLI-side connectivity checks against the cluster and PAM.\nUse --deep (or supply --s3-bucket / --nfs-path / --recipe) to also\ntrigger cluster-side deployment checks via the broker's /v1/check\nendpoints (K8s API, NFS, S3, recipe execution, DB).\n",
         "allow_extra": false,
         "parent": "clusters",
         "is_placeholder": false
@@ -2280,7 +2279,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Rotate the cluster RSA keypair.\n\n    Generates a new keypair, updates the cluster record in PAM with the\n    new public key, patches the K8s secret with the new private key,\n    and restarts the cluster deployment.\n    ",
+        "description": "Rotate the cluster RSA keypair.\n\nGenerates a new keypair, updates the cluster record in PAM with the\nnew public key, patches the K8s secret with the new private key,\nand restarts the cluster deployment.\n",
         "allow_extra": false,
         "parent": "clusters",
         "is_placeholder": false
@@ -3030,7 +3029,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Export all the examples from a dataset and save it in the designated file as\n    JSONL (newline-delimited JSON).\n    ",
+        "description": "Export all the examples from a dataset and save it in the designated file as\nJSONL (newline-delimited JSON).\n",
         "allow_extra": false,
         "parent": "datasets",
         "is_placeholder": false
@@ -3465,7 +3464,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Deploy or upgrade the Ellf Helm chart.\n\n    Creates the namespace, image pull secret, cluster keypair secret,\n    then runs helm upgrade --install with the provided values.\n    ",
+        "description": "Deploy or upgrade the Ellf Helm chart.\n\nCreates the namespace, image pull secret, cluster keypair secret,\nthen runs helm upgrade --install with the provided values.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -3709,7 +3708,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Install cluster infrastructure prerequisites (Traefik, cert-manager).\n\n    These operations are idempotent and safe to re-run.\n    ",
+        "description": "Install cluster infrastructure prerequisites (Traefik, cert-manager).\n\nThese operations are idempotent and safe to re-run.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -3992,7 +3991,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "Manage TLS certificates for local cluster access.\n\n    Use --self-signed when you have direct kubectl access to the cluster.\n    Use --setup HOST to do everything from your laptop over SSH.\n    Use --trust HOST to fetch and install an existing CA from a remote cluster.\n    ",
+        "description": "Manage TLS certificates for local cluster access.\n\nUse --self-signed when you have direct kubectl access to the cluster.\nUse --setup HOST to do everything from your laptop over SSH.\nUse --trust HOST to fetch and install an existing CA from a remote cluster.\n",
         "allow_extra": false,
         "parent": "infra",
         "is_placeholder": false
@@ -4016,7 +4015,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "\n    Run a job directly on the cluster from a YAML spec file, bypassing PAM.\n    ",
+        "description": "\nRun a job directly on the cluster from a YAML spec file, bypassing PAM.\n",
         "allow_extra": false,
         "parent": "jobs",
         "is_placeholder": false
@@ -5094,7 +5093,7 @@
             "orig_type": "str"
           }
         ],
-        "description": "\n    Upload and advertise a recipes package from your Python environment.\n    ",
+        "description": "\nUpload and advertise a recipes package from your Python environment.\n",
         "allow_extra": false,
         "parent": "publish",
         "is_placeholder": false
@@ -5207,7 +5206,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    Transfer data to the cluster, and advertise it to Ellf.\n\n    These steps can also be done separately. See `ellf files` to transfer\n    data to the cluster without creating an Asset record for it, and\n    `ellf assets create` to create an Asset without transfer.\n    ",
+        "description": "\nTransfer data to the cluster, and advertise it to Ellf.\n\nThese steps can also be done separately. See `ellf files` to transfer\ndata to the cluster without creating an Asset record for it, and\n`ellf assets create` to create an Asset without transfer.\n",
         "allow_extra": false,
         "parent": "publish",
         "is_placeholder": false
@@ -5762,7 +5761,7 @@
             "orig_type": "List[str]"
           }
         ],
-        "description": "\n    Create a new service. The available service recipes are fetched from your\n    cluster and are added as dynamic subcommands. You can see more details\n    and available arguments by calling the subcommand with --help, e.g. create\n    [name] --help\n    ",
+        "description": "\nCreate a new service. The available service recipes are fetched from your\ncluster and are added as dynamic subcommands. You can see more details\nand available arguments by calling the subcommand with --help, e.g. create\n[name] --help\n",
         "allow_extra": true,
         "parent": "services",
         "is_placeholder": false
@@ -6228,7 +6227,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Print the bearer-token-authenticated URL for a service.\n\n    Mints a fresh 90-day token via ``POST /v1/service/issue-token`` and\n    formats it together with the service's public URL so the result can\n    be dropped into an MCP client config or curl invocation:\n\n        curl -H \"Authorization: Bearer <token>\" <url>\n\n    Use ``services rotate-token`` to mint a new token without printing\n    the URL again.\n    ",
+        "description": "Print the bearer-token-authenticated URL for a service.\n\nMints a fresh 90-day token via ``POST /v1/service/issue-token`` and\nformats it together with the service's public URL so the result can\nbe dropped into an MCP client config or curl invocation:\n\n    curl -H \"Authorization: Bearer <token>\" <url>\n\nUse ``services rotate-token`` to mint a new token without printing\nthe URL again.\n",
         "allow_extra": false,
         "parent": "services",
         "is_placeholder": false
@@ -6289,7 +6288,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Mint a fresh 90-day token for an existing service.\n\n    Issuing a new token does not invalidate previous ones -- they remain\n    valid until their own expiration. Use this when the previous token\n    is leaked, or when you want a longer remaining window for an MCP\n    client config.\n    ",
+        "description": "Mint a fresh 90-day token for an existing service.\n\nIssuing a new token does not invalidate previous ones -- they remain\nvalid until their own expiration. Use this when the previous token\nis leaked, or when you want a longer remaining window for an MCP\nclient config.\n",
         "allow_extra": false,
         "parent": "services",
         "is_placeholder": false
@@ -6509,7 +6508,7 @@
             "orig_type": "List[str]"
           }
         ],
-        "description": "\n    Create a new task. The available task recipes are fetched from your\n    cluster and are added as dynamic subcommands. You can see more details\n    and available arguments by calling the subcommand with --help, e.g. create\n    [name] --help\n    ",
+        "description": "\nCreate a new task. The available task recipes are fetched from your\ncluster and are added as dynamic subcommands. You can see more details\nand available arguments by calling the subcommand with --help, e.g. create\n[name] --help\n",
         "allow_extra": true,
         "parent": "tasks",
         "is_placeholder": false
@@ -6544,7 +6543,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "\n    List the tasks on the cluster. By default, this includes their ID, name\n    and current state, e.g. created or completed\n    ",
+        "description": "\nList the tasks on the cluster. By default, this includes their ID, name\nand current state, e.g. created or completed\n",
         "allow_extra": false,
         "parent": "tasks",
         "is_placeholder": false
@@ -6975,7 +6974,7 @@
             "orig_type": "bool"
           }
         ],
-        "description": "Fetch a batch of questions from a running annotation task.\n\n    Mirrors the web app: asks the broker for a Prodigy login token, then talks\n    to the task pod directly via its public task_url. Note that requesting a\n    batch reserves those questions for this CLI's session \u2014 they will not be\n    handed to other annotators until they are answered or another session\n    runs out of work and steals them.\n    ",
+        "description": "Fetch a batch of questions from a running annotation task.\n\nMirrors the web app: asks the broker for a Prodigy login token, then talks\nto the task pod directly via its public task_url. Note that requesting a\nbatch reserves those questions for this CLI's session \u2014 they will not be\nhanded to other annotators until they are answered or another session\nruns out of work and steals them.\n",
         "allow_extra": false,
         "parent": "tasks",
         "is_placeholder": false

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/ellf_skills/skills/ellf-annotate.coding/SKILL.md

@@ -2,6 +2,7 @@
 name: ellf-annotate
 description: "Set up and launch annotation from the coding environment once the methodology, schema, and data are ready. Use when the user wants to start annotation on the Ellf cluster, run a local Prodigy annotation server, choose between built-in Ellf and built-in Prodigy recipes, verify that annotation is ready to launch, preview the annotation setup, or determine whether a new custom recipe is needed. Also trigger on \"I want to annotate\", \"start a local Prodigy server\", \"launch annotation on the cluster\", \"which recipe should I use\", \"can I run this locally\", \"set up review\", or \"help me run annotation\". This skill is the annotation readiness gatekeeper: it applies the audit checklist before launch, prefers built-in workflows when possible, and delegates to `/ellf-prodigy` when a new custom recipe must be implemented."
 argument-hint: "[describe what you want to annotate]"
+allowed-tools: Bash(ellf info defaults:*)
 ---
 
 # Launch Annotation From Coding
@@ -10,6 +11,13 @@ Help the user get from an annotation-ready plan to a working annotation process.
 
 $ARGUMENTS
 
+## Current Ellf session context
+
+The block below is auto-filled from your local Ellf CLI each time this skill loads. Read it instead of trying to discover the project, cluster, or task yourself. There is **no** `ellf project current` / `ellf projects current` command — these saved defaults are what such a command would return, and most `ellf` commands fall back to them automatically. To change one, run `ellf config <project|task|action|agent|...> <name_or_id>`.
+
+Saved CLI defaults:
+!`ellf info defaults`
+
 ## Your role
 
 You are responsible for:

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/ellf_skills/skills/ellf-monitor.coding/SKILL.md

@@ -2,6 +2,7 @@
 name: ellf-monitor
 description: "Monitors Ellf jobs, local Prodigy servers, training progress, and cluster health — keeps raw logs out of context and produces structured summaries. Includes a structured training check script, alert classification (overfitting, plateau, NaN loss, spikes), annotation metrics, and diagnostic routing. Use proactively after launching any job, not just when the user asks. Also trigger on status checks, log inspection, 'how's the task doing', 'what failed', or training metric questions."
 argument-hint: "[job name, job type, output dir, or 'cluster']"
+allowed-tools: Bash(ellf info defaults:*)
 ---
 
 # Monitor Jobs From Coding
@@ -10,6 +11,13 @@ You are the monitoring and diagnosis skill for the coding environment.
 
 $ARGUMENTS
 
+## Current Ellf session context
+
+The block below is auto-filled from your local Ellf CLI each time this skill loads. Read it instead of trying to discover the project, cluster, or task yourself. There is **no** `ellf project current` / `ellf projects current` command — these saved defaults are what such a command would return, and most `ellf` commands fall back to them automatically. To change one, run `ellf config <project|task|action|agent|...> <name_or_id>`.
+
+Saved CLI defaults:
+!`ellf info defaults`
+
 ## Contents
 - Scope — what this skill does and doesn't do
 - Monitoring surfaces — cluster jobs, local runs, Prodigy servers, cluster health

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/ellf_skills/skills/ellf-ops.coding/SKILL.md

@@ -2,6 +2,7 @@
 name: ellf-ops
 description: "Executes Ellf operations from the coding environment: creating, starting, stopping, or inspecting tasks, actions, or agents; managing assets, datasets, files, secrets, or packages; publishing data or code; managing projects, path aliases, or cluster health. Includes verification rules, failure handling workflows, and secret management guidance. Use --help on recipes to discover args, then follow the workflows for execution and verification."
 argument-hint: "[ready launch spec or job operation]"
+allowed-tools: Bash(ellf info defaults:*)
 ---
 
 # Execute Operations From Coding
@@ -10,6 +11,13 @@ You are the execution skill for operational workflows in the coding environment.
 
 $ARGUMENTS
 
+## Current Ellf session context
+
+The block below is auto-filled from your local Ellf CLI each time this skill loads. Read it instead of trying to discover the project, cluster, task, action, or agent yourself. There is **no** `ellf project current` / `ellf projects current` command — these saved defaults are what such a command would return, and most `ellf` commands fall back to them automatically. To change one, run `ellf config <project|task|action|agent|...> <name_or_id>`.
+
+Saved CLI defaults:
+!`ellf info defaults`
+
 ## Scope
 
 You execute ready operations. You do not:

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/ellf_skills/skills/ellf-prodigy/SKILL.md

@@ -2,6 +2,7 @@
 name: ellf-prodigy
 description: Develop and test custom Prodigy annotation recipes — both standalone Prodigy and Ellf. Has templates, API reference, built-in recipe catalog, and a lint script. Use when the user needs a custom recipe built, wants to edit or fix recipe code, asks about "recipe.py", "custom annotation workflow", or any request to write/modify/troubleshoot Prodigy recipe Python code. Also trigger for porting standalone recipes to Ellf or vice versa.
 argument-hint: "[describe your annotation task or recipe to edit]"
+allowed-tools: Bash(ellf info defaults:*), Bash(ellf plans list:*)
 ---
 
 # Prodigy Recipe Developer
@@ -10,6 +11,16 @@ You develop and test custom Prodigy annotation recipes.
 
 $ARGUMENTS
 
+## Current Ellf session context
+
+The block below is auto-filled from your local Ellf CLI each time this skill loads. Read it instead of trying to discover the project or other defaults yourself. There is **no** `ellf project current` / `ellf projects current` command — these saved defaults are what such a command would return, and most `ellf` commands fall back to them automatically. To change one, run `ellf config <project|task|action|agent|...> <name_or_id>`.
+
+Saved CLI defaults:
+!`ellf info defaults`
+
+Plans in the saved project (`ellf plans list` and the other `ellf plans` commands default to it):
+!`ellf plans list`
+
 ## Setup
 
 This is a coding-only skill. Work from the local coding environment and current
@@ -36,9 +47,10 @@ current codebase, and existing recipe package structure.
    every task needs a custom recipe. If they still want custom, understand what
    the built-in is missing.
 
-2. **Check the shared project plan** using the current local project context.
-   Extract task type, labels, data source, runtime target, and any recipe
-   recommendations already agreed elsewhere.
+2. **Check the shared project plan.** The injected "Current Ellf session context"
+   above lists the plans in the saved project — read the relevant one with
+   `ellf plans read` (it defaults to the saved project). Extract task type, labels,
+   data source, runtime target, and any recipe recommendations already agreed elsewhere.
 
 3. **Gather requirements** you don't already have: annotation task type, labels,
    data source, model assistance (manual / model-correct / active learning /

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/ellf_skills/skills/ellf-project.coding/SKILL.md

@@ -2,6 +2,7 @@
 name: ellf-project
 description: Plan an NLP project end-to-end with an opinionated consultant. Covers problem framing, data strategy, annotation, pipeline design, evaluation, and deployment planning, grounded in spaCy, Prodigy, Ellf workflows and applied NLP best practices. Use whenever the user asks how to approach an NLP task, needs help deciding between rules, ML, and LLMs, wants advice on label scheme design, needs pipeline architecture guidance, asks how to break a vague NLP problem into concrete steps, or says things like "how should I build this", "what's the best approach for", "help me plan", "I need to extract/classify/annotate", "how do I structure this project", or "what should I do next". Also trigger when the user seems unsure about their NLP approach, has a vague requirement that needs scoping, or needs a shared project plan created or updated.
 argument-hint: "[describe your NLP problem]"
+allowed-tools: Bash(ellf info defaults:*), Bash(ellf plans list:*)
 ---
 
 # NLP Project Consultant
@@ -13,6 +14,16 @@ You do not dump generic questionnaires. You listen, react, recommend, and ask th
 
 $ARGUMENTS
 
+## Current Ellf session context
+
+The block below is auto-filled from your local Ellf CLI each time this skill loads. Read it instead of trying to discover the project or other defaults yourself. There is **no** `ellf project current` / `ellf projects current` command — these saved defaults are what such a command would return, and most `ellf` commands fall back to them automatically. To change one, run `ellf config <project|task|action|agent|...> <name_or_id>`.
+
+Saved CLI defaults:
+!`ellf info defaults`
+
+Plans in the saved project (`ellf plans list` and the other `ellf plans` commands default to it):
+!`ellf plans list`
+
 ## Contents
 - Your role — planning, not implementation
 - Shared project plan — local CLI plan access and lifecycle
@@ -65,7 +76,7 @@ In the coding environment, use the local `ellf plans` workflow. `<project_id>` i
 - `ellf plans revisions <name_or_id> [<project_id>] [--size N] [--after <cursor>]` — paginated history of one plan, newest first. `name_or_id` is required here (no default).
 - `ellf plans delete <name_or_id> [<project_id>]` — delete a plan by name or UUID.
 
-If you need to resolve the current project ID first, use the local project context before reading or writing plans. Do not guess the project ID.
+The `ellf plans` commands already default to the saved project when `<project_id>` is omitted, so you usually don't need to resolve it. If you do need the current project ID explicitly, read it from `ellf info defaults` (the `project` field). Do not guess the project ID, and note there is no `ellf project`/`ellf projects current` command — use `ellf info defaults` to read the saved default and `ellf config project <name_or_id>` to change it.
 
 Do not ask the user where to store the plan.
 

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/ellf_skills/skills/ellf-support.coding/SKILL.md

@@ -2,6 +2,7 @@
 name: ellf-support
 description: Prepare and send a support request from the coding environment when the user wants human help from the Ellf team. Use when the user wants to escalate an issue, asks for human review, wants to contact support, or says things like "I need support", "can someone look at this", "send this to the Ellf team", or "I'm stuck". This skill gathers the issue, summarizes the current state, asks whether to attach the full Claude Code transcript, and sends the request with `ellf support create`.
 argument-hint: "[describe your issue]"
+allowed-tools: Bash(ellf info defaults:*)
 ---
 
 # Human Support From Coding
@@ -10,6 +11,13 @@ Help the user escalate to human support cleanly and accurately.
 
 $ARGUMENTS
 
+## Current Ellf session context
+
+The block below is auto-filled from your local Ellf CLI each time this skill loads. Use the saved `project` here as the default target for the support request — do not try to discover it with `ellf project current` / `ellf projects current` (no such command). If the saved project looks wrong or stale for this request, fall back to `ellf projects list --json` and confirm with the user (see "Resolve the target project" below).
+
+Saved CLI defaults:
+!`ellf info defaults`
+
 ## Scope
 
 You are not implementing a fix here. Your job is to:
@@ -57,8 +65,8 @@ Use the current conversation first.
 
 Resolve the target project before you submit the request.
 
-- If the current project is explicit from local project context or prior confirmed
-  state, use it.
+- If the current project is explicit (the saved `project` in the injected session
+  context above, or prior confirmed state), use it.
 - If there is any ambiguity about which project the support request belongs to,
   use `ellf projects list --json` to gather candidates, then use `AskUserQuestion`
   to confirm the project with the user before running `ellf support create`.

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/ellf_cli/ellf_skills/skills/ellf-train.coding/SKILL.md

@@ -2,6 +2,7 @@
 name: ellf-train
 description: "Trains spaCy models locally or on the Ellf cluster — from config generation and experiment design through training execution to result interpretation and troubleshooting. Covers architecture selection, model selection, training diagnostics, and evaluation methodology. Use whenever training is about to happen: creating a training action, choosing a base model, generating a config, designing experiments, interpreting scores, or debugging training problems. Also trigger on training curves, loss values, F-scores, or 'my model isn't learning'."
 argument-hint: "[describe what you want to train, or provide a dataset name]"
+allowed-tools: Bash(ellf info defaults:*), Bash(ellf plans list:*)
 ---
 
 # NLP Model Training
@@ -10,11 +11,21 @@ You help users go from annotated data to a trained spaCy model — locally or on
 
 $ARGUMENTS
 
+## Current Ellf session context
+
+The block below is auto-filled from your local Ellf CLI each time this skill loads. Read it instead of trying to discover the project or other defaults yourself. There is **no** `ellf project current` / `ellf projects current` command — these saved defaults are what such a command would return, and most `ellf` commands fall back to them automatically. To change one, run `ellf config <project|task|action|agent|...> <name_or_id>`.
+
+Saved CLI defaults:
+!`ellf info defaults`
+
+Plans in the saved project (`ellf plans list` and the other `ellf plans` commands default to it):
+!`ellf plans list`
+
 ## Setup
 
 1. **Read `${CLAUDE_SKILL_DIR}/references/workflow.md`** — this is your decision flowchart. It tells you where you are in the training process and what to do next. Read it on every invocation.
 
-2. **Check for a shared project plan** using the current project context. Read the current plan with the local `ellf plans` commands and extract training-relevant context such as task type, labels, data decisions, prior architecture choices, and any previous launch decisions.
+2. **Check for a shared project plan.** The injected "Current Ellf session context" above already lists the plans in the saved project — pick the relevant one and read it with `ellf plans read` (it defaults to the saved project, so you don't resolve a project ID first). Extract training-relevant context such as task type, labels, data decisions, prior architecture choices, and any previous launch decisions.
 
 3. **Check for `training_history.md`** in the working directory. If found, the Current Status section tells you where things stand. Resume from there.
 

{ellf_cli-7.0.0 → ellf_cli-10.0.1/ellf_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ellf-cli
-Version: 7.0.0
+Version: 10.0.1
 Summary: Ellf Command Line Interface
 Home-page: https://prodi.gy
 Author: ExplosionAI GmbH

{ellf_cli-7.0.0 → ellf_cli-10.0.1}/tests/test_login.py

@@ -156,6 +156,64 @@ def test_install_claude_skills_with_packaged_plugin(tmp_path, monkeypatch):
     assert (dest / "ellf-patterns").is_dir()
 
 
+def _patch_login_collaborators(monkeypatch, *, cluster_error=None):
+    """Patch login()'s collaborators so it can run without network access.
+
+    Returns (auth, install_mock, configure_mock). When ``cluster_error``
+    is given, cluster selection raises it.
+    """
+    from ellf_cli.commands import general
+
+    auth = MagicMock()
+    monkeypatch.setattr(general, "get_auth_state", lambda: auth)
+    monkeypatch.setattr(general, "_select_and_persist_org", MagicMock())
+    cluster_mock = MagicMock(side_effect=cluster_error)
+    monkeypatch.setattr(general, "_select_and_persist_cluster", cluster_mock)
+    install_mock = MagicMock()
+    configure_mock = MagicMock()
+    monkeypatch.setattr(general, "_install_claude_skills", install_mock)
+    monkeypatch.setattr(general, "_configure_claude_mcp", configure_mock)
+    return auth, install_mock, configure_mock
+
+
+def test_login_claude_installs_skills_despite_cluster_failure(monkeypatch):
+    """Regression: cluster auth failure must not block Claude skill setup.
+
+    Skill install and MCP config only need the device-flow tokens, so
+    they run before cluster selection and survive any cluster error.
+    """
+    import pytest
+
+    from ellf_cli.commands import general
+    from ellf_cli.errors import CLIError, EllfError
+
+    auth, install_mock, configure_mock = _patch_login_collaborators(
+        monkeypatch, cluster_error=EllfError("cluster token mint failed")
+    )
+
+    with pytest.raises(CLIError):
+        general.login(claude=True)
+
+    install_mock.assert_called_once_with()
+    configure_mock.assert_called_once_with(auth)
+
+
+def test_login_wraps_transport_and_cli_errors_with_no_cluster_hint(monkeypatch):
+    """Broker-unreachable (httpx) and no-cluster (CLIError) failures get the
+    same --no-cluster hint as EllfError instead of a raw traceback."""
+    import httpx
+    import pytest
+
+    from ellf_cli.commands import general
+    from ellf_cli.errors import CLIError
+
+    for error in (httpx.ConnectError("connection refused"), CLIError("no clusters")):
+        _patch_login_collaborators(monkeypatch, cluster_error=error)
+        with pytest.raises(CLIError) as exc_info:
+            general.login()
+        assert "--no-cluster" in str(exc_info.value)
+
+
 def _fake_membership(org_id, org_name="acme"):
     return SimpleNamespace(
         org_id=org_id,