skore-cli

Command-line interface for skore.

skore-cli installs a single skore command with three areas:

• skills — discover, install and manage Agent Skills from the probabl-ai/skills catalog
• agent — connect a project to the Skore Hub agent, write harness config and launch a local coding agent
• sync — synchronize report projects across local storage, Skore Hub, and MLflow

Installation

pip install skore-cli

The base install is batteries-included: it bundles the agent feature (so it pulls in skore). No extras are required.

Usage

Skills

Install skills into the current project by default. Pass --global/-g for a user-wide install and --agent/-a to target specific agents (agents, claude-code, cursor, codex, gemini, windsurf, cline, roo, amp, github-copilot, bob, bob-ide). Pass --repo owner/name on install to pull from another GitHub catalog that ships .catalog.json (the default is probabl-ai/skills). Interactive skore skills install also lets you edit that owner/name in the wizard; --repo only pre-fills the field. list and update reuse the stored source and show it in their output; they do not take --repo.

agents is the cross-client default (.agents/skills). Other names write the tool's native SKILL.md directory. Most global installs mirror that folder under your home directory; Windsurf uses ~/.codeium/windsurf/skills, Amp uses ~/.config/agents/skills, and Copilot in VSCode has no user-level skills directory (--global is rejected). Bob Shell and Bob IDE share .bob/skills.

skore skills list          # list installed skills (with source)
skore skills install       # install skills (interactive or by id)
skore skills install --repo acme/skills gamma
skore skills update        # update from each skill's recorded source
skore skills remove        # remove installed skills

Agent

On the first run, skore agent logs in when needed, lets you pick a workspace and harness, creates a workspace API key, writes the harness configuration and launches the agent. Supported harnesses: Bob Shell, Bob IDE, Claude CLI, Claude UI, Claude Plugin (Cursor, VS Code, or VS Code Insiders), Cursor IDE, Cursor CLI, OpenCode, Pi, Copilot in VSCode, Copilot CLI and Codex CLI (detected via PATH, the application bundle on macOS for Bob IDE and Claude UI, or the Claude Code extension for Claude Plugin). The interactive picker lists detected harnesses first, then the ones that are not installed. --harness claude / claude-cli is the CLI; claude-ui is the desktop app. --harness claude-plugin asks which IDE to open; claude-plugin-cursor, claude-plugin-code, and claude-plugin-code-insiders select that IDE. --harness cursor is Cursor IDE; cursor-cli is the agent binary. Bob IDE also accepts --harness bobide — the name of the command its installer puts on PATH — as an alias for --harness bob-ide. Later runs reuse .skore in the project directory (gitignored). Use SKORE_HUB_URI (or --hub-url) to point at a non-default hub.

Launching a harness exports the .skore credentials as SKORE_HUB_API_KEY and SKORE_HUB_URI, so skore.login() in the scripts the agent runs authenticates with that key instead of opening a browser. Values already set in your environment are left untouched.

skore agent
skore agent --harness claude    # non-interactive harness choice
skore agent --workspace ./myapp # configure another project directory

Sync

Synchronize a source project to a destination mode. The source defaults to local when only --to is set; the destination defaults to local when only --from is set.

# Local -> Hub (add --both or --dry-run as needed)
SKORE_HUB_API_KEY=... skore sync experiment --to=hub --to-workspace=team

# Hub -> local with a different project name
SKORE_HUB_API_KEY=... skore sync production \
  --from=hub --from-workspace=team --to-project=downloaded

# Local -> MLflow
skore sync experiment --to=mlflow --tracking-uri=http://localhost:5000

Hub synchronization requires SKORE_HUB_API_KEY. Use --hub-url to target a custom Hub API. Install skore[mlflow] to synchronize with MLflow.

Agent detection

When skore is run inside a coding agent, it detects the agent from environment variables and adapts its behavior:

• skore (no args) shows an agent-specific quick-start with the detected agent's skill directory and harness
• skore skills install (no args, non-interactive) prints the catalog and the detected agent's skill directory — no --agent flag needed
• skore skills install all installs all skills into the detected agent's directory (also works with --all)
• skore skills install <ids> installs specific skills into the detected agent's directory
• skore agent (no --harness, non-interactive) auto-selects the detected agent's harness and skips the launch step (the agent is already running)

Any non-empty value triggers detection.

License

MIT