Skip to main content

# kater app search

Finds the apps you can open whose name, label, description or creator holds your text.

{/* Written by apps/landing-page/scripts/docs/write_cli_reference.py from the kater CLI's own help and scripts/docs/cli-reference.md. Do not edit it by hand: change those, then run the script. */}

The match ignores case. It takes the same filters as [`kater app list`](https://kater.ai/docs/cli-reference/app/list/).

## Examples

```bash
# Find the apps that have paid media in their name, label or description
kater app search "paid media"
# Find the apps that a teammate made and shared with you
kater app search teammate@example.com --collection shared
# Find the apps about spend that you can change in one connection
kater app search spend --connection snowflake_prod_connection --editable
```

## Arguments

<div class="cli-options">

| Argument | Description |
| --- | --- |
| `<text>` | The text to find in an app's name, label, description or creator, such as `"paid media"`. Put text with spaces in quotes. |

</div>

## Options

<div class="cli-options">

| Option | Description |
| --- | --- |
| `--connection <name>` | Finds only the apps in this connection, such as `snowflake_prod_connection`. |
| `--workspace <path>` | Finds only the apps in this workspace, by its full path from the content root. |
| `--collection <collection>` | Which apps to search: `all`, the default, searches every app you can open. `mine` searches the apps in your own folder. `shared` searches the apps someone else made that you can open. |
| `--editable` | Finds only the apps you can change. |

</div>

It also takes the [global options](https://kater.ai/docs/cli-reference/global-options/) `--json`, `--kater-root`, `--scope` and `--help`.

## Where the results come from

The results come from the Kater API, not from your local copy. The CLI asks the same API as every other command, signed in as you: see [Install and sign in](https://kater.ai/docs/cli-reference/install/).

## See also

- [`kater app`](https://kater.ai/docs/cli-reference/app/)
- [All commands](https://kater.ai/docs/cli-reference/kater/)

On this page

Examples
Arguments
Options
Where the results come from
See also

Kater CLI Present and share app

kater app search

Finds the apps you can open whose name, label, description or creator holds your text.

The match ignores case. It takes the same filters as kater app list.

Examples

# Find the apps that have paid media in their name, label or description
kater app search "paid media"
# Find the apps that a teammate made and shared with you
kater app search teammate@example.com --collection shared
# Find the apps about spend that you can change in one connection
kater app search spend --connection snowflake_prod_connection --editable

Arguments

Argument	Description
`<text>`	The text to find in an app’s name, label, description or creator, such as `"paid media"`. Put text with spaces in quotes.

Options

Option	Description
`--connection <name>`	Finds only the apps in this connection, such as `snowflake_prod_connection`.
`--workspace <path>`	Finds only the apps in this workspace, by its full path from the content root.
`--collection <collection>`	Which apps to search: `all`, the default, searches every app you can open. `mine` searches the apps in your own folder. `shared` searches the apps someone else made that you can open.
`--editable`	Finds only the apps you can change.

It also takes the global options --json, --kater-root, --scope and --help.

Where the results come from

The results come from the Kater API, not from your local copy. The CLI asks the same API as every other command, signed in as you: see Install and sign in.

See also