CLI Command Reference

This section is organized by top-level command families. It works more like an index into the command tree than a copy of every terminal help screen. Its job is to help you quickly answer:

• which command tree you should enter
• what that command family is responsible for
• which level of the command tree to open next

If you already know that your task is about apps, dashboards, datasets, pipelines, or permissions, this reference is usually faster than jumping through workflow pages repeatedly.

How to use this reference

Recommended order:

1. Find the relevant command family on this page
2. Open the corresponding subpage to see the common subcommands
3. Before execution, use the CLI --help output for exact flags and examples

Global options

These options appear across most commands:

Option	Purpose	Typical use
-o, --output	Select output format	table for direct reading, json / yaml for agents, scripts, and CI
-c, --config	Select a config file path	Switch between local config files explicitly
--api-url	Override the target instance API URL	Temporarily override HBI_API_URL
--token	Override the current access token	Use a temporary token instead of saved credentials
--dry-run	Preview a write without executing it	Useful before grants, config changes, and deletes
--yes	Auto-confirm side effects	Non-interactive runs and batch jobs
--lang	Select CLI language	Currently zh-CN and en-US

Command family map

Command family	Main scope	Continue reading
auth search config preferences scheduler logs	authentication, search, local CLI config, system preferences, schedules, and logs	Core & Runtime Commands
app folder dashboard element	apps, folders, dashboards, and page elements	App & Dashboard Commands
connection dataset data-model metric measure pipeline notebook data-alert data-agent	data onboarding, modeling, metrics, execution, and AI-related capabilities	Data & Execution Commands
user user-group org user-attr tenant subject kanban permission authorize	users, orgs, tenants, permissions, subject domains, and kanban resources	Users, Tenants & Permission Commands

How to keep drilling down

This reference mainly helps you decide which command tree to enter first, not reproduce every --help page. A simple way to think about drill-down is:

If you need to...	Start with this command tree
manage app parameters, shared dimensions, rules, subscriptions, or portal settings	app -> app param / app dimension / app rule / app subscribe / app portal
work on dashboard plans or themes	dashboard -> dashboard plan / dashboard theme
create or update charts and page elements	element -> element chart / element filter / element container / element text
edit pipeline nodes	pipeline -> pipeline edit

Once you have located the right command tree, use that level's --help in the terminal for exact flags and examples.

Chinese aliases

The CLI still supports Chinese aliases for first-level commands, for example:

hbi 应用 list
hbi 数据集 preview
hbi 仪表盘 show

If your team mixes human operators and agents, it is still better to standardize on the English command tree for consistency with scripts, skills, and help output.