> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirage.strukto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLIs

> Install typed command-line programs beside your mounts and let agents act on services by name.

Mounts make a service readable as files; CLIs make it actionable as a
program. A CLI is a typed program tree (`CLISpec`) installed on the
workspace by name, completely separate from any mount: it initializes
from its own config, consults no mount, and takes no operand path. The
shell dispatches a line to a CLI when its first word matches an
installed name.

```python theme={null}
from mirage import Workspace
from mirage.commands.cli.builtin.himalaya import HIMALAYA

ws = Workspace({"/mail": EmailResource(config)})
ws.register_cli("himalaya", HIMALAYA, config.model_dump())

await ws.execute("himalaya envelope list --unseen --max 5")
```

In YAML the same install rides the `clis:` section:

```yaml theme={null}
mounts:
  /mail:
    resource: email
    config: { ... }
clis:
  himalaya:
    spec: himalaya
    config: { ... }
```

Every level of the tree answers `--help`, unknown verbs fail with git's
wording (exit 1), and missing required flags fail with argparse's
wording (exit 2). Two installs under different head words are two
accounts.

## Builtin CLIs

| Program                          | Acts on          | Vocabulary                                   |
| -------------------------------- | ---------------- | -------------------------------------------- |
| [himalaya](/python/cli/himalaya) | IMAP/SMTP mail   | pimalaya/himalaya (`envelope`, `message`)    |
| [gws](/python/cli/gws)           | Google Workspace | official Google Workspace CLI                |
| [slack](/python/cli/slack)       | Slack            | OpenClaw Slack actions (`send-message`, …)   |
| [discord](/python/cli/discord)   | Discord          | OpenClaw Discord actions (`send`, `poll`, …) |
| [ntn](/python/cli/ntn)           | Notion           | official Notion CLI (`pages`, `datasources`) |
| [linear](/python/cli/linear)     | Linear           | noun/verb (`issue create`, `team list`)      |

Reading stays on the mount (`cat`, `grep`, `jq` over the virtual
files); acting goes through the CLI. The mounted tree's
`<name>__<id>` path segments supply the IDs the CLI flags take.