How do I install the Tos CLI skill?

Run npx skillmds@latest add volcengine/tos-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tos CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tos CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tos CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tos CLI?

volcengine (@volcengine) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tos CLI by volcengine — Agent Skill

Name: Tos CLI
Author: volcengine

Tos CLI

Use tos-cli for ByteCloud TOS object storage work. Trigger this skill when a user asks an AI agent to inspect, configure, list, upload, download, sync, delete, presign, diagnose, or automate ByteCloud TOS resources with the tos-cli command-line tool.

volcengine 7b74af7 3 files · 3.3 KB Updated Sep 17, 2026

File contents

tos-cli

Use the tos-cli binary for ByteCloud TOS object storage. Check availability with tos-cli --version before planning commands, and use the first matching executable on PATH unless the user provides an explicit path. Do not run storage operations if the binary is missing.

CLI installation

If tos-cli --version fails and the user wants installation help, suggest one of these installation methods:

cargo install tos-cli
npm install -g tos-cli
pip install tos-cli
brew tap volcengine/ve-storage-uni-cli https://github.com/volcengine/ve-storage-uni-cli
brew install tos-cli
winget install tos-cli
curl -fsSL https://github.com/volcengine/ve-storage-uni-cli/releases/latest/download/install.sh | sh -s -- tos-cli

Read references/safety.md before commands that write, delete, move, overwrite, sync, change config, or expose signed URLs.

Discovery

tos-cli capabilities --view compact --output json
tos-cli doctor --output json
tos-cli config show --output json

Connection configuration

tos-cli config init does not choose a region, endpoint, or PSM. Configure an endpoint explicitly; a recognizable endpoint may supply the signing region, while a custom endpoint also needs an explicit region. For ByteTOS PSM mode, configure both region and PSM and do not configure endpoint.

tos-cli config set access_key_id <byte-tos-access-key>
tos-cli config set secret_access_key <byte-tos-secret-key>
tos-cli config set endpoint https://your-bytetos-endpoint.example.com
tos-cli config set region cn-beijing
# Alternative PSM mode in another profile (no endpoint in that profile):
tos-cli config set psm-profile.region cn-beijing
tos-cli config set psm-profile.psm toutiao.tos.tosapi

Bare AK/SK keys are stored under the active profile's [profile.tos] credentials section, independently from ve-tos-cli credentials.

Common Commands

tos-cli ls tos://bucket/prefix/ --output json
tos-cli stat tos://bucket/key --output json
tos-cli cp ./file.txt tos://bucket/file.txt --dry-run
tos-cli sync ./dir tos://bucket/prefix/ --dry-run
tos-cli presign tos://bucket/key --expires 3600 --output json

Use tos-cli <command> --help when flags are uncertain.

---name: tos-clidescription: Use tos-cli for ByteCloud TOS object storage work. Trigger this skill when a user asks an AI agent to inspect, configure, list, upload, download, sync, delete, presign, diagnose, or automate ByteCloud TOS resources with the tos-cli command-line tool.---# tos-cliUse the `tos-cli` binary for ByteCloud TOS object storage. Check availabilitywith `tos-cli --version` before planning commands, and use the first matchingexecutable on `PATH` unless the user provides an explicit path. Do not run storage operations if the binary is missing.## CLI installationIf `tos-cli --version` fails and the user wants installation help, suggest one ofthese installation methods:```bashcargo install tos-clinpm install -g tos-clipip install tos-clibrew tap volcengine/ve-storage-uni-cli https://github.com/volcengine/ve-storage-uni-clibrew install tos-cliwinget install tos-clicurl -fsSL https://github.com/volcengine/ve-storage-uni-cli/releases/latest/download/install.sh | sh -s -- tos-cli```Read `references/safety.md` before commands that write, delete, move, overwrite,sync, change config, or expose signed URLs.## Discovery```bashtos-cli capabilities --view compact --output jsontos-cli doctor --output jsontos-cli config show --output json```## Connection configuration`tos-cli config init` does not choose a region, endpoint, or PSM. Configure anendpoint explicitly; a recognizable endpoint may supply the signing region,while a custom endpoint also needs an explicit region. For ByteTOS PSM mode,configure both region and PSM and do not configure endpoint.```bashtos-cli config set access_key_id <byte-tos-access-key>tos-cli config set secret_access_key <byte-tos-secret-key>tos-cli config set endpoint https://your-bytetos-endpoint.example.comtos-cli config set region cn-beijing# Alternative PSM mode in another profile (no endpoint in that profile):tos-cli config set psm-profile.region cn-beijingtos-cli config set psm-profile.psm toutiao.tos.tosapi```Bare AK/SK keys are stored under the active profile's `[profile.tos]`credentials section, independently from `ve-tos-cli` credentials.## Common Commands```bashtos-cli ls tos://bucket/prefix/ --output jsontos-cli stat tos://bucket/key --output jsontos-cli cp ./file.txt tos://bucket/file.txt --dry-runtos-cli sync ./dir tos://bucket/prefix/ --dry-runtos-cli presign tos://bucket/key --expires 3600 --output json```Use `tos-cli <command> --help` when flags are uncertain.

Frequently asked questions