---
title: "oz0 conversation mine"
description: "List your own chats (conversations whose first turn you started) and those shared with you or a team of yours, pinned first, then by last activity."
canonical_url: "https://docs.oz0.ai/reference/cli/oz0/conversation/mine"
---
# oz0 conversation mine

> List your own chats (conversations whose first turn you started) and those shared with you or a team of yours, pinned first, then by last activity.

For: Operators and developers looking up a command.

List your own chats (conversations whose first turn you started) and those shared with you or a team of yours, pinned first, then by last activity. Titles and previews need the content permission. A chat is unread (*) when it changed since you last read it.

Archived chats are left out unless --archived; --page-token goes on from where a page ended, and --all reads every page and shows each chat once, even one pinned or unpinned while the pages are read. Chats are private to their owner and those they share them with: nobody else's are listed.

## Usage

```bash
oz0 conversation mine [flags]
```

## Flags

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

<tbody>
  <tr>
    <td>
      <code>
        --agent
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      only one agent's chats
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --all
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      read every page, not one
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --archived
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      only archived chats
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --cursor
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      the older name of --page-token, for a cursor an earlier version printed
    </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>
        --limit
      </code>
    </td>
    
    <td>
      int32
    </td>
    
    <td>
      
    </td>
    
    <td>
      at most this many rows a page (the server's 25 when 0, at most 100)
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --page-token
      </code>
    </td>
    
    <td>
      string
    </td>
    
    <td>
      
    </td>
    
    <td>
      go on after the page before: the token it printed
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --pinned
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      only pinned chats
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        --shared
      </code>
    </td>
    
    <td>
      bool
    </td>
    
    <td>
      
    </td>
    
    <td>
      only chats others shared with you
    </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.