---
url: https://docs.mochiexec.io/reference/cli/mochi_browse.md
description: Discover and explore available executables.
---

# mochi browse

Discover and explore available executables.

## Synopsis

Browse executables across workspaces.

flow browse           # Interactive multi-pane executable browser
flow browse --list    # Simple list view of executables
flow browse VERB \[ID] # Detailed view of specific executable

See https://flowexec.io/types/flowfile#executableverb for more information on executable verbs and
https://flowexec.io/types/flowfile#executableref for more information on executable references.

```shell
mochi browse [EXECUTABLE-REFERENCE] [flags]
```

## Examples

```shell
mochi browse                              # interactive multi-pane browser
mochi browse --list                       # flat list of all executables
mochi browse --verb run                   # list only 'run' executables
mochi browse --namespace myproject        # filter by namespace
mochi browse --namespace 'myproject/*'    # include nested namespaces
```

## Options

| Flag | Type | Description |
|------|------|-------------|
| `-a, --all` |  | List from all namespaces. |
| `--annotation` | `stringArray` | Filter by annotations. Format: 'key=value' for exact value match, or 'key' for presence regardless of value. Repeat the flag for multiple selectors; all selectors must match (AND). |
| `-f, --filter` | `string` | Filter executable by reference substring. |
| `-h, --help` |  | help for browse |
| `-l, --list` |  | Show a simple list view of executables instead of interactive discovery. |
| `-n, --namespace` | `string` | Filter executables by namespace. Use 'ns/\*' to include nested namespaces. |
| `-o, --output` | `string` | Output format. One of: yaml, json, or tui. |
| `-t, --tag` | `stringArray` | Filter by tags. |
| `-v, --verb` | `string` | Filter executables by verb. |
| `--visibility` | `string` | Filter by visibility level (hierarchical). Valid: public, private, internal, hidden. Default: private |
| `-w, --workspace` | `string` | Filter executables by workspace. |

## Options inherited from parent commands

| Flag | Type | Description |
|------|------|-------------|
| `-L, --log-level` | `string` | Log verbosity level (debug, info, fatal) (default "info") |
| `--sync` |  | Sync flow cache and workspaces |

## See also

* [mochi](mochi.md) — Run and organize your development tasks