cli-hub（CLI HUB 搜索）

cli-hub — Unified CLI Gateway

One Skill to search and invoke all enterprise and AI creation tools (WeCom / DingTalk / Lark / Dreamina), covering 91+ tools.

Installation

Recommended (from PyPI, package signatures verified):

pip install agent-cli-hub     # pip
pipx install agent-cli-hub    # pipx (isolated env)
uv tool install agent-cli-hub # uv

PyPI: https://pypi.org/project/agent-cli-hub/ Source: https://github.com/agentrix-ai/clihub (MIT License)

Alternative (convenience script, internally runs pip from PyPI):

curl -sSL https://raw.githubusercontent.com/agentrix-ai/clihub/main/install.sh | bash

After installation, cli-hub is available as a command.

Mandatory Rules

1. Never guess commands — Always cli-hub search to find the tool ID first.
2. Check params before calling — Always cli-hub info <id> to confirm the parameter schema.
3. On error, consult the "Error Handling" table below.

Standard Workflow

Follow Steps 1 → 2 → 3 → 4 strictly in order.

Step 1: Check Environment (required on first use)

cli-hub doctor

Based on output:

• not installed → install the CLI
• installed but not authenticated → run auth
• All OK → skip to Step 2

Install underlying CLIs:

cli-hub install wecom              # WeCom
cli-hub install dingtalk           # DingTalk
cli-hub install lark               # Lark/Feishu
cli-hub install dreamina           # Dreamina AI
cli-hub install --all              # All providers
cli-hub install lark --timeout 300 # Increase timeout for slow networks

Authenticate (interactive, requires browser):

cli-hub auth wecom
cli-hub auth dingtalk
cli-hub auth lark
cli-hub auth dreamina              # Dreamina (terminal QR code login)
cli-hub auth --status              # Check all auth status

Step 2: Search Tools

cli-hub search "send message"
cli-hub search "create todo" --provider lark
cli-hub search "generate video" --provider dreamina
cli-hub search "meeting" --json     # Recommended for agents: JSON with input_schema

Step 3: Check Parameters

cli-hub info wecom.msg.send_message        # Table format
cli-hub info wecom.msg.send_message --json # Recommended for agents: full JSON Schema

Shows: parameter name, type, required (*), example, command template.

Step 4: Invoke Tool

Method A — JSON arguments (WeCom style):

cli-hub run wecom.msg.send_message --args '{"chat_type":1,"chatid":"user1","msgtype":"text","text":{"content":"hello"}}'

Method B — Flag arguments (DingTalk / Lark / Dreamina style):

cli-hub run lark.im.messages_send --chat-id oc_xxx --text "Hello"
cli-hub run dingtalk.todo.task_create --title "Write report" --executors userId
cli-hub run dreamina.generate.text2image --prompt "a cat portrait" --ratio 1:1

How to choose? cli-hub info <id> Example field shows the underlying CLI's argument style.

Utility Commands

Decision Tree

User intent
├── Unsure which platform → cli-hub search "<description>"
├── Know platform, not tool → cli-hub list <provider>
├── Found tool ID → cli-hub info <id> → cli-hub run <id> [args]
├── "not installed" → cli-hub install <provider>
├── "not authenticated" → cli-hub auth <provider>
├── "Operation not found" → cli-hub search again
├── "timed out" → cli-hub install <provider> --timeout 300
└── Unsure about env → cli-hub doctor

Error Handling

Supported Platforms

Notes

• Authentication is interactive; the agent should prompt the user to complete browser authorization
• For Dreamina, use dreamina login --headless (terminal QR code); generation consumes credits — warn the user
• Dreamina tasks are async: after submit, use query_result --submit_id=<id> to check results
• Search results are ranked by relevance; prefer the highest-scored tool
• Invoke tools one at a time and confirm results before proceeding