harbor

Hub

Hub

Managing Jobs on the Hub

The Harbor Hub can be used to store, share, and host jobs, datasets, and tasks. When a job is uploaded, the hub provides a comprehensive overview page allowing you to examine costs, token consumption, and performance across many dimensions.

The harbor CLI ships with commands analogous to the viewers provided on the hub website.

All of the harbor hub viewer commands share the same entrypoint harbor hub.

Listing Jobs

Using the command harbor hub job list you can print out a list of all jobs visible to your user on the hub.

Flags

The list command supports numerous flags that offer fine-grained observability into your jobs.

  • --scope my | shared | all alters the visibility scope of the returned jobs, defaulting to my for jobs owned by your user
  • --search TEXT returns only jobs whose names contain a matching substring
  • --agent NAME NAME_2 ... filters jobs by agent name. Accepts multiple entries (e.g. --agent codex claude-code) will return jobs that utilize either codex or claude-code
  • --provider NAME NAME_2 ... filters jobs by model provider. Accepts multiple entries
  • --model NAME NAME_2 ... filters jobs by model. Accepts multiple entries

Job Overview

Use the command harbor hub job show JOB_ID JOB_ID_2 ... to print an overview similar to the one provided on the hub.

This viewer displays the following information

  • Number of trials
  • Number of errors
  • Number of retries
  • Average return on metrics
  • Cost (in USD)
  • Token Usage

Per-Task Job Breakdown

Use the command harbor hub job tasks JOB_ID to see a per-task breakdown of a job.

Flags

  • --search TEXT returns only tasks whose names contain a matching substring
  • --agent / --provider / --model same as above

Trials Overview

Use the command harbor hub job trials JOB_ID JOB_ID_2 ... to list trials across one or more jobs. In interactive terminals, you can switch pages to audit all trials without running a second command.

Flags

  • --search TEXT filter by text matching trial names
  • --agent / --provider / --model same as above
  • --limit N page size (defaults to 100 here)
  • --failed-only only trials that errored/failed
  • --all-attempts include all retries, not just the final attempt
  • --sort-by COL started_at | task_name | name| error_type
  • --sort-order asc|desc

Comparing 2 or More Jobs

Use command harbor hub job compare JOB_ID JOB_ID_2 ... to get the side-by-side grid for performance on tasks

Job Visibility

Use command harbor hub job shares JOB_ID to see who a job is shared with. This returns orgs and users

Combined Flags

In addition to those listed. the following options are available

  • -q, --quiet prints only IDs for piping into xargs
  • --no-trunc show full cell content (wrap cells instead of ellipsis)
  • --no-headers omit the header row
  • --page N pull a particular page (disables interactive pages)
  • --json get result as raw JSON
  • --debug show full traceback on failure

On this page