---
title: "oz0 plugin versions"
description: "Every version of a plugin the tenant has had, newest first: its version, commit, whether it is the installed one or a candidate, and how its quality gate ended."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/plugin/versions"
---
# oz0 plugin versions

> Every version of a plugin the tenant has had, newest first: its version, commit, whether it is the installed one or a candidate, and how its quality gate ended.

For: Operators and developers looking up a command.

Every version of a plugin the tenant has had, newest first: its version, commit, whether it is the installed one or a candidate, and how its quality gate ended. A version made by an agent (its commit carries the OZ trailers push_changes writes, or its hub listing says so) shows the job, the agent and its plugin version, the model alias and the model, and the evidence the change rested on, each by an ID you can open.

A job that is not one of this tenant's is shown as text only: the trailers are whatever the commit's author wrote.

## Usage

```bash
oz0 plugin versions <plugin> [flags]
```

## Flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --json
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      print JSON instead of a table
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --page-size
      </code>
    </td>
    
    <td>
      int32
    </td>
    
    <td>
      <code>
        25, at most 200
      </code>
    </td>
    
    <td>
      versions per page
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --page-token
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the next page, as the previous page's last line names it
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --tenant
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        default
      </code>
    </td>
    
    <td>
      tenant
    </td>
  </tr>
</tbody>
</table>

## Inherited flags

<table>
<thead>
  <tr>
    <th>
      Flag
    </th>
    
    <th>
      Type
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      Description
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        --context
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        $OZ0_CONTEXT or &lt;config dir>/orchestrator-zero/context.json
      </code>
    </td>
    
    <td>
      CLI context file written by server init
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --log-level
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        info
      </code>
    </td>
    
    <td>
      log level: debug, info, warn or error
    </td>
  </tr>
</tbody>
</table>

See [all `oz0` commands](https://docs.oz0.ai/reference/cli/oz0) and the [global flags](https://docs.oz0.ai/reference/cli/oz0#global-flags).


## Sitemap

See the full [sitemap](https://docs.oz0.ai/sitemap.md) for all pages.