hyper-cli

# Hyper CLI Use `hyperai` to run any marketing skill from a terminal. A skill names each tool once, by its canonical name, for example `gmail_messages_send`. The CLI runs that name directly. ## Requirements - **Hyper MCP configured for the workspace.** [https://app.hyperfx.ai/mcp](https://app.hyperfx.ai/mcp) - **Required integrations connected** at [https://app.hyperfx.ai/apps](https://app.hyperfx.ai/apps). The sibling marketing skill lists which integrations it needs. - **Hyper CLI installed and authenticated.** Verify with `hyperai info`. If `hyperai info` fails, stop and tell the user to authenticate the CLI before calling tools. ## The four commands | Need | Command | | --- | --- | | Confirm auth and workspace | `hyperai info` | | Find a tool | `hyperai search "<what you want to do>"` | | Read a tool's input schema | `hyperai describe <name> --parameters` | | Run a tool | `hyperai call <name> --json '{...}'` | `<name>` is the canonical tool name from the skill, such as `meta_ads_adaccount_list`. The CLI also accepts the same name as separate words (`meta-ads adaccount list`); a skill never uses that form. If your CLI version rejects the canonical name, run `hyperai search "<name>"`: the result prints the exact `hyperai call ...` line to use. Update the CLI with `hyperai update`. ## Connected accounts | Need | Command | | --- | --- | | List the connected accounts for a toolkit | `hyperai call connections_list --json '{"toolkit_id": "gmail"}'` | | Switch the active account for this shell | `hyperai call connections_use --json '{"toolkit_id": "gmail", "auth_id": "<auth_id>"}'` | The active account is kept per shell session, the same way the MCP keeps it per session. ## Arguments - Pass arguments as one JSON object with `--json`. The CLI validates them against the tool's schema before calling. - When a call fails with an argument error, run `hyperai describe <name> --parameters` and read the schema. Do not retry the same arguments. - Large results: add `--raw` to get the unformatted JSON. ## Example ```bash hyperai info hyperai search "send an email" hyperai describe gmail_messages_send --parameters hyperai call gmail_messages_send --json '{"to": "jane@example.com", "subject": "Hello", "body": "Hi Jane"}' ``` ## Out of scope | Need | Skill | | --- | --- | | What to send, to whom, in which sequence | the marketing skill that owns the job, for example `cold-email-outreach` | | MCP client setup | the Hyper MCP page at [https://app.hyperfx.ai/mcp](https://app.hyperfx.ai/mcp) |