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

> Usage and flags for oz0 plugin eject.

For: Operators and developers looking up a command.

Write the full folder of a plugin that is one part on its own (an agent in one file, a flow file or a skill, with no oz0-plugin.yaml), for when it needs code of its own, evals or more parts: oz0-plugin.yaml with the generated manifest's name, kind and uses:, agents/\<name>.yaml with the agent's fields as written (addresses kept) and instructions: prompts/\<name>.md, the prompt with the file's body, and evals/\<name>.yaml with one case to fill in; a flow goes to flows/ with its evals, a skill to skills/\<name>/.

The plugin keeps its name and its version, so installing the folder over the installed plugin updates it and its versions and rollouts go on: the version is --version, else the installed plugin's when your CLI context's server has it, else the generated one. Change version: in oz0-plugin.yaml when you release a new one. It writes into --out (default: a folder of the plugin's name here) and refuses one that has files.

## Usage

```bash
oz0 plugin eject <file.md | folder> [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --out
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the folder to write (default: a folder of the plugin's name in the current folder); it must be empty or new
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --tenant
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        default
      </code>
    </td>
    
    <td>
      the tenant whose installed plugin's version eject keeps
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --version
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      <code>
        the installed plugin's, else the generated one
      </code>
    </td>
    
    <td>
      the manifest's version
    </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.