bytedcli

Route and execute ByteDance internal R&D platform operations through the bytedcli command-line interface.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill bytedcli-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bytedcli
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/bytedcli
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill bytedcli-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @bytedance-dev/bytedcli, and includes references (resource) components.

What problem does it solve? ByteDance engineers juggle dozens of internal platforms (Codebase, TCE, TCC, Feishu, RDS, Merlin, and more), each with its own console and API. This Skill teaches the agent to route any internal R&D task to the correct bytedcli command domain instead of opening web pages or hand-writing internal API calls. ## Core Features & Use Cases - Unified command routing: Maps user tasks to 60+ command domains covering code review, releases, configuration, logs, data queries, approvals, and collaboration. - Domain guides and references: Ships per-domain guides (TCE, Feishu, Merlin, ES, Lark DevOps, and more) plus invocation, command-surface, and troubleshooting references for precise flags and safety rules. - Guarded write operations: Documents dry-run-first workflows, confirmation gates, and safety rules for destructive actions like cluster updates, instance deletion, and release submissions. - Use Case: Ask the agent to "check the CI for this MR" or "query slow logs for my PSM" and it selects the right domain (codebase, log), applies the correct site and authentication, and returns structured JSON output. ## Quick Start Ask the agent to handle a ByteDance internal platform task, such as checking the status of a merge request or querying logs for a service, and it will route the request through the appropriate bytedcli command.

Frequently Asked Questions about bytedcli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run bytedcli commands without installing anything?

Run the latest version directly with npx using the internal registry: NPM_CONFIG_REGISTRY=http://bnpm.byted.org npx -y @bytedance-dev/bytedcli@latest <command>. Alternatively, install it globally with npm install -g and call bytedcli directly.

How do I choose the right bytedcli command domain for a task?

Match the task to its platform or artifact: MRs and CI go to codebase, config changes to tcc, deployments to tce, Feishu docs and messages to feishu, and SQL or database work to rds, hive, dorado, or aeolus. When unsure, run bytedcli <domain> --help or consult the command-surface reference.

Does bytedcli support TikTok and international sites?

Yes, use the global --site flag or BYTEDCLI_CLOUD_SITE environment variable with values like cn, i18n-bd, i18n-tt, eu-ttp, or boe. Authentication is isolated per SSO environment, so i18n-tt and eu-ttp require a separate auth login from cn.

Why does bytedcli return 401 or authentication errors after switching sites?

Authentication is isolated by SSO environment, so logging into cn does not authenticate i18n-tt or eu-ttp. Run auth login for the target site explicitly, for example BYTEDCLI_CLOUD_SITE=i18n-tt bytedcli auth login, then verify with auth status.

How do I get machine-readable JSON output from bytedcli?

Add the global --json flag before the command domain, for example bytedcli --json auth status. Placing --json after the subcommand does not work, which is a common cause of unstable output.

What safety rules apply to destructive bytedcli operations?

Write operations like TCE cluster updates, instance deletion, and Lark DevOps releases require a dry-run first, explicit user confirmation, and flags such as --execute --yes-i-know-this-is-live. Instance deletion must be serial, one pod at a time, with re-verification after each step.