Command reference

Run probe <group> --help for the flags on any of these.

Setup and account

Everything in this section has a wizard screen, and the wizard is the better door at a keyboard — it shows you the current state before it changes anything. These are the scriptable equivalents. The full map is on the wizard overview.

Command	Does	In the wizard
`probe install`	Straight into the guided install	Install Probe
`probe wizard`	The setup wizard itself	—
`probe doctor`	Read-only diagnostic: what is installed, on, and whether auto-update works	Diagnose a problem
`probe login`	Browser device flow, or `--token` for the paste path	Account → Sign in
`probe logout`	Stop imports, revoke the calling token, clear local config	Sign out
`probe whoami`	The current principal	the On this device block
`probe context`	`list` · `show` · `use` · `delete` — named local accounts	Account → Switch
`probe token`	`list` · `create` · `revoke`	none — minting needs a browser
`probe mcp`	`status` · `headers` · `env` · `token set` / `unset`	paired during install

Structure

Command	Does
`probe workspace`	`list` · `get` · `create` · `rename` · `delete` · `use` · `writers`
`probe project`	`create` · `list` · `get` · `set` · `use` · `tag` · `move` · `delete` · `reference` · `code` · `contributors`
`probe experiment`	`create` · `get` · `set` · `list` · `tag` · `freeze` · `reproduce` · `edges` · `delete`
`probe group`	`create` · `list` · `get` · `set` — sweeps, ensembles, distributed runs
`probe version`	`create` · `list` — immutable experiment version manifests
`probe access-group`	`list` · `create` · `rename` · `delete` · `add` · `remove`
`probe commits`	One page of a project’s commit timeline, newest first

Runs

Command	Does
`probe run`	`start` · `fork` · `child` · `set` · `list` · `tag` · `end` · `check` · `reproduce` · `get` · `series` · `metrics` · `delete`
`probe exec`	Run a command under a run, holding it with a heartbeat
`probe get`	Print a run
`probe bundle`	Print a run bundle: run, series and artifacts
`probe events`	Backend lifecycle events for a run
`probe link`	Attach foreign keys under `metadata.foreign_keys`

Telemetry

Command	Does
`probe log`	Append metric points. `--dim` adds series dimensions
`probe metrics`	`grouped` · `wide` · `export` · `plot` · `backfill` · `delete`
`probe series`	`latest` — cross-run scalar summary
`probe coordinates`	The run’s coordinate catalog
`probe views`	`list` · `show` · `create` · `preview` · `data` · `rename` · `delete`
`probe span`	`add` · `list` · `get`
`probe trial`	`list` · `get` · `set` · `add` · `stage` · `reconcile` · `export` · `drain` · `watch` · `expand`
`probe edge`	`add` · `remove` — lineage

Files

Command	Does
`probe artifact`	`add` · `list` · `tree` · `move` · `download` · `versions` · `version-add` · `pin-impact` · `gc-uploads` · `delete`
`probe shared`	`list` · `add` · `share` · `unshare` · `download` · `delete`
`probe snapshot`	Non-disruptive code and environment capture
`probe snapshot-show`	The captured code manifest, one file per line
`probe snapshot-restore`	Rebuild the captured tree, or say exactly what is missing

Prose

Command	Does
`probe notes`	`show` · `checkout` · `push` · `write` · `list` · `create` · `rename` · `delete` · `status` · `team` · `sync` · `audit-advisory`
`probe paper`	`add` · `list` · `update` · `tag` · `edges` · `remove`
`probe rule`	`preview` · `declare` · `publish` · `list` — workflow memory
`probe agent-rules`	`refresh` — the managed Probe block in your agent’s memory file

Sessions

Command	Does
`probe session`	`state` · `track` · `untrack` · `toggle` · `status` · `default`
`probe statusline`	`install` · `uninstall` · `status` · `show`

Imports

These run in the foreground and hold the terminal. The wizard’s Import research work runs the same imports in the background, survives a disconnect, and resumes after a restart — prefer it for anything large. See Backfill.

Command	Does
`probe backfill`	Import work you have already done: point an agent at a folder
`probe wandb`	`discover` · `import-local` · `import-hosted` · `key`
`probe import wandb`	Mirror one W&B run’s metric history into an existing run

Delivery

Command	Does
`probe outbox`	`status` · `drain` · `watch` · `retry` · `discard` · `pause` · `resume`
`probe flush`	Deliver everything queued and wait (alias of `outbox drain`)

The outbox

What queues, what blocks, and what to do when delivery fails.

Reserved

probe hook session attach / checkpoint / detach exists for deterministic coding-agent adapters and is not part of the researcher workflow. No hooks are installed by the current release.

Getting started

Setup wizard

Tracking your work

Python SDK

CLI

Coding agents

Dashboard

Integrations and imports

Deploy and operate

Reference

Setup and account

Structure

Runs

Telemetry

Files

Prose

Sessions

Imports

Delivery

The outbox

Reserved

​Setup and account

​Structure

​Runs

​Telemetry

​Files

​Prose

​Sessions

​Imports

​Delivery

The outbox

​Reserved

Setup and account

Structure

Runs

Telemetry

Files

Prose

Sessions

Imports

Delivery

Reserved