hyper-cli skill
Run Hyper marketing skills and tools directly from a terminal using the hyperai command-line interface.
- GitHub stars
- 112
- Files
- 1
- Last commit
- Nov 11, 2026
- License
- MIT
- Allowed tools
- —
What does the hyper-cli skill do?
hyper-cli runs Hyper marketing skills and tools directly from a terminal using the hyperai command-line interface.
Summary generated from the skill's SKILL.md.
About the hyper-cli skill
Executing marketing automation tasks from a terminal environment is what hyper-cli enables for developers and marketers. By using the hyperai command-line interface, users can run specific marketing skills and tools outside of an MCP-native agent host. This is useful when you need to interact with tools like gmail_messages_send or meta_ads_adaccount_list directly through a shell.
The interface provides several commands to manage your workflow. You can use hyperai info to verify your authentication and workspace, hyperai search to locate specific capabilities, and hyperai describe to inspect tool input schemas. To execute a task, you use the hyperai call command followed by the canonical tool name and a JSON object containing your arguments.
Managing connections is also possible within the CLI. You can list connected accounts for a specific toolkit or switch the active account for your current shell session using the connections_list and connections_use commands. This ensures that your terminal sessions maintain the correct authentication context for the marketing tools you are running.
What an agent can do with it
- 1Locate specific marketing toolsFind a tool by searching for a natural language description of the task.
- 2Inspect tool requirementsRead the input schema for a tool to ensure arguments are formatted correctly.
- 3Execute marketing actionsRun a marketing tool by its canonical name using a JSON object for arguments.
- 4Manage account authenticationSwitch the active account for a specific toolkit within your current shell session.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the hyper-cli skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the hyper-cli skill in Plugin
/plugin marketplace add hyperfx-ai/marketing-skills /plugin install hyper-marketing@hyperfx-marketing-skills
Install the hyper-cli skill in Claude Code
~/.claude/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.claude/skills/hyper-cliInstall the hyper-cli skill in Claude Code (project)
.claude/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli .claude/skills/hyper-cliInstall the hyper-cli skill in Codex
~/.agents/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.agents/skills/hyper-cliInstall the hyper-cli skill in Gemini CLI
~/.gemini/skills/hyper-cli/SKILL.md
$ npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.gemini/skills/hyper-cliInstall the hyper-cli skill in Claude.ai
npx degit hyperfx-ai/marketing-skills/skills/hyper-cli hyper-cli && zip -r hyper-cli.zip hyper-cli # claude.ai → Customize → Skills → + → Create skill → Upload a skill → hyper-cli.zip
SKILL.md
View on GitHubHyper 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
- Required integrations connected at 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> --parametersand read the schema. Do not retry the same arguments. - Large results: add
--rawto get the unformatted JSON.
Example
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 |
Files in this skill
1hyper-cli skill questions
How do I install the hyper-cli skill in Claude Code?
Run npx degit hyperfx-ai/marketing-skills/skills/hyper-cli ~/.claude/skills/hyper-cli. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the hyper-cli skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
How do I find a specific tool in the Hyper CLI?
You can use the command hyperai search "<what you want to do>" to find a tool.
How can I see the required input parameters for a tool?
Use the command hyperai describe <name> --parameters to read a tool's input schema.
How do I switch the active account for a toolkit in my current shell?
Use the command hyperai call connections_use --json '{"toolkit_id": "<toolkit_id>", "auth_id": "<auth_id>"}'.
What should I do if the CLI rejects a canonical name?
Run hyperai search "<name>" to get the exact command line to use, or update your CLI with hyperai update.