---
title: "oz0 usage outside"
description: "Usage and flags for oz0 usage outside."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/usage/outside"
---
# oz0 usage outside

> Usage and flags for oz0 usage outside.

For: Operators and developers looking up a command.

Shows the spend a plugin granted provides: [outside-spend] imported, such as ai.oz0/ai-spend from Anthropic's and OpenAI's admin cost reports, per month, provider, model and team, and the tenant's own metered spend per month beside it. Amounts are in the currency the provider gave and never converted. Under works-council mode the teams with fewer people than the threshold are summed into one row that names none of them. Nothing is shown per person or per API key. Tenant readers may.

## Usage

```bash
oz0 usage outside [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --by
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      sum each month by provider, model or team only
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --json
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      print JSON instead of a table
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --months
      </code>
    </td>
    
    <td>
      int32
    </td>
    
    <td>
      <code>
        3
      </code>
    </td>
    
    <td>
      how many months, the current one included (1 to 24)
    </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.