---
title: "oz0 hub search"
description: "Search the plugins the cluster's trusted indexes offer, by their facets: facts the engine computed from each listed version's code and manifest, never what its authors say."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/hub/search"
---
# oz0 hub search

> Search the plugins the cluster's trusted indexes offer, by their facets: facts the engine computed from each listed version's code and manifest, never what its authors say.

For: Operators and developers looking up a command.

Search the plugins the cluster's trusted indexes offer, by their facets: facts the engine computed from each listed version's code and manifest, never what its authors say.

- --models takes any-model (no agent names a vendor's model), needs:\<vendor>, local-capable (every agent can run on a local model and nothing reaches past the node) or sampling.
- --harness takes a harness's name.
- --kind takes connector, capability, policy, set or unknown.
- --connects takes a connection's name or a host.
- --trust takes verified (one of the project's verified plugins), publisher-proven, custody or no-advisories.
- --platform takes an OS, any or tier-1.
- --function takes the type of at least one of its functions, in the tool policy's words: read, write, sends-out, destructive or unknown (what its calls do, as the install screen groups them).
- --permission takes what the plugin may do on a node, by its listing's permission sections: shell, write (files), unchecked, network, secrets, hooks, outside-input, approvals or uses.
- --tag takes an author's tag.

A flag may be repeated or take a comma-separated list: a plugin matches any value of a flag and every flag given. The server filters and counts: after the plugins come, for each facet, how many plugins the search would hold with it added. The text matches the name and the summary. It reads the copies the cluster has and fetches nothing.

## Usage

```bash
oz0 hub search [text] [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --connects
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      a connection's name or a host it reaches
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --function
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      read, write, sends-out, destructive or unknown: a type one of its functions has
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --harness
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      a harness's name, such as codex
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --index
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      only this index
    </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>
        --kind
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      connector, capability, policy, set or unknown
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --models
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      any-model, needs:&lt;vendor>, local-capable or sampling
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --permission
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      what it may do on a node: shell, write, unchecked, network, secrets, hooks, outside-input, approvals or uses
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --platform
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      an OS such as linux, any, or tier-1
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --tag
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      an author's tag
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --trust
      </code>
    </td>
    
    <td>
      strings
    </td>
    
    <td>
      
    </td>
    
    <td>
      verified, publisher-proven, custody or no-advisories
    </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.