sergeinikolenko/clearml-codex-plugin/clearml

ClearML

Use this skill when the user asks about ClearML experiments, metrics, runs, logs, task status, project snapshots, or ClearML comparison links.

Defaults

• Prefer read-only MCP tools from this plugin. Never create, enqueue, archive, delete, or mutate ClearML objects.
• Do not ask the user to paste credentials. The plugin reads the standard ClearML SDK configuration or environment variables.
• When comparing training runs, compare at a shared step by default. Latest-only comparisons can be misleading when tasks have different progress.
• Lead with task status and domain metrics that answer the user's question, then mention losses/logs as supporting evidence.
• Prefer outcome metrics over loss curves when the user asks for a domain verdict.
• If task ids are not supplied, search tasks first by project, name, tags, and status.

Tool Routing

• Use clearml_search_tasks to find task ids by project/name/tags/status.
• Use clearml_project_snapshot for questions like "what is running in this project" or "show the latest runs".
• Use clearml_experiment_slice when the user wants a compact data dump for several experiments.
• Use clearml_compare_tasks for focused equal-step metric tables.
• Use clearml_scalar_series for one metric over time.
• Use clearml_task_logs and clearml_task_events when the user asks whether a run is healthy or stuck.
• Use clearml_compare_url when the user asks for a ClearML UI comparison link.

Browser Behavior

If the user asks to open or inspect a ClearML page, first build or identify the URL. If Browser tools are available in the thread, open the URL in the in-app browser and inspect it. If Browser tools are not available, return the URL and say that a browser-enabled thread can inspect the page.

Output Shape

For comparisons, report:

1. Compared task aliases and ids.
2. Shared target step and how it was selected.
3. Direct verdict on the requested metrics.
4. Caveats about missing metrics, different metric variants, or very early steps.
5. ClearML compare URL when project id is known.