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

# ocean-cli — the nouns

> Grammar: ocean-cli <noun> <verb> [ARGS] [--flags]. Every flag: see the ocean-cli skill's references/verbs.md (generated from --help), or run ocean-cli <noun> <verb> --help (every leaf carries an example).


<!-- sources-of-truth: apps/ocean-cli/src/index.ts apps/ocean-cli/src/commands/ | full tree: apps/ocean-skills/skills/ocean-cli/references/verbs.md -->

Grammar: `ocean-cli <noun> <verb> [ARGS] [--flags]`. Every flag: see the `ocean-cli` skill's `references/verbs.md`
(generated from `--help`), or run `ocean-cli <noun> <verb> --help` (every leaf carries an example).

## Account (no noun)

| Command | What it does |
|---|---|
| `login`, `logout`, `auth` | Sign in (browser by default), clear, and inspect credentials |
| `whoami`, `doctor` | Identity, tier and rate window; live checks of every plane |
| `config [key] [value]` | View or set the host URLs and the default search provider |
| `update [--check]`, `completion show\|install`, `skills list\|install\|uninstall` | Self-update, shell completion, PlungeAI agent skills |

## Web (API key)

| Command | What it does |
|---|---|
| `search`, `extract`, `answer` | Web search, clean markdown from URLs, a cited answer |
| `research run\|status\|poll\|result\|processors` | Deep research (paid, minutes) |
| `findall run\|status\|poll\|result\|cancel\|ingest\|entity-search\|extend\|enrich\|schema` | Discover entities from the web |
| `monitor create\|list\|get\|update\|cancel\|trigger\|events` | Track the web for changes (`create` is refused by the unattended fence) |
| `enrich run\|suggest\|status\|poll` | Add web-researched columns to CSV or JSON rows |

## Platform (API key)

| Command | What it does |
|---|---|
| `agents list\|categories\|get\|run\|result` | Registry agents |
| `tools list\|get\|call` | Tool agents: contracts and typed calls |
| `workflows list\|get\|create\|update\|delete\|versions\|restore\|validate\|run\|result\|cancel\|build\|save-version` | Saved CNL workflows (`--kind bot` for bots) |
| `workflows permissions get\|set`, `files`, `inbox`, `bindings list\|bind\|unbind` | A bot's policy, workspace files, inbox and bound chats |
| `bot-groups list\|create\|update\|delete\|thread` | Named sets of 2 to 6 bots |
| `executions list\|get\|conversation\|cancel\|output\|delete\|status\|poll\|continue\|followup\|steer\|files\|export` | Runs |
| `missions run\|status\|poll\|result` | Bounded autonomous runs with memory (`type: harness`) |
| `schedules stats\|list\|get\|runs\|pause\|resume\|run-now\|delete\|create\|update\|wake` | Cron, one-time and ending jobs |
| `schedules triggers webhook\|email\|hooks mint\|list\|delete` | Inbound webhook and email triggers, outbound signed run hooks |
| `memory recall\|remember\|search-runs\|get-run`, `learn add\|list\|forget`, `templates list\|get\|use` | Memory, learned skills, templates |
| `chat send\|new\|sessions\|history` | Platform chat turns |
| `discovery search\|recommend\|card`, `models list\|chat\|embed`, `mcp tools\|runs …`, `traces get` | The registry, the models plane, MCP, traces |

## Studio session

`balance`, `usage`, `keys list\|create\|revoke`, `nodes …`, `campaigns …`, `connections …`, `secrets …`, `documents …`,
`teams …`, `projects …`, `executions export` — all need `ocean-cli login --session`.