cloudbase-cli

CloudBase CLI

Manage CloudBase resources via tcb CLI — deterministic, scriptable, auditable. Primary interface for CI/CD and batch ops; also the first-session fallback when MCP tools are not yet available in the conversation.

Sibling skills (local only)

Sibling CloudBase skills ship beside this skill. Use local relative paths such as ../auth-tool-cloudbase/SKILL.md.

If a referenced sibling skill file is missing from this environment, ask the user to install the full CloudBase plugin (or the missing skill). Do not HTTP-fetch remote skill or protocol markdown into the agent context.

Cross-cutting protocols (required before code changes or deployments):

• Change Safety Protocol: ../cloudbase-platform/references/protocols/change-safety-protocol.md
• Deployment Gate: ../cloudbase-platform/references/protocols/deployment-gate.md
• MCP vs CLI fallback: ../cloudbase/references/tooling-fallback.md (packaged beside this skill as the cloudbase entry guideline)

Core Principles

1. `--help` first — never guess commands.

tcb CLI changes between versions. Before using any command for the first time, run tcb <command> --help to check parameters and discover official doc links.

1. Deployment Gate.

Before any deployment, publish, custom domain, or CloudRun operation, you must first complete the checks in cloudbase-platform/references/protocols/deployment-gate.md.

1. Verify your work.

After deploying or modifying any resource, run the corresponding list/detail command to confirm the change took effect.

1. Dry-run before destructive actions.

Use --dry-run for delete/overwrite operations. Show the preview to the user and wait for explicit confirmation before executing.

1. Confirm environment first.

Always verify envId with the user before operations. Run tcb env use <envId> to avoid accidentally modifying production.

1. Recover from errors, don't loop.

If a command fails after 2-3 attempts, check the exit code ($?), read the error message, consult tcb docs search, and try a different approach.

1. First-session fallback, not MCP replacement.

If CloudBase MCP tools are missing in this session, use this skill to unblock login/manage. Still configure MCP (plugin / mcp.json) so the next session can prefer MCP. When MCP tools are already available, prefer MCP unless the user asked for CLI/CI. Route deploy work through the domain reference table below — do not recommend tcb deploy.

1. No npm/npx.

If Node/npm/npx are missing, tell the user to install Node.js LTS (or use the IDE marketplace MCP path) before retrying CLI/plugin install. See guideline tooling-fallback.md.

When to use this skill

Use when the user wants to manage CloudBase resources via command line, or when MCP is not usable yet:

• First session / post-install: MCP not in the tool list, or just configured and needs restart → tcb login + the matching domain command now; leave MCP ready for next session
• Deploy/debug cloud functions, static hosting, CloudRun services (via domain refs — not tcb deploy)
• Manage storage, hosting, databases (NoSQL/MySQL)
• Configure permissions, CORS, domains, routing
• CI/CD scripting, batch operations, terminal-based resource management
• User explicitly prefers CLI over MCP

Do NOT use for

• SDK-based in-app integration (web/miniprogram/node) → use cloud-functions,

cloudbase-document-database-web-sdk, auth-web-cloudbase, etc.

• When CloudBase MCP tools are already available in this session and the user did not ask for CLI → prefer MCP
• Console UI operations
• CloudBase Agent SDK development → use cloudbase-agent-ts

How to use this skill (for a coding agent)

1. Always load `references/core.md` first — it covers authentication,

environment switching, tcb docs queries, and error diagnosis.

1. Route to the correct domain reference using the Routing table below.
2. Load only the one reference file that matches the user's task.

Do not preload all references.

1. Stop loading more context once you have the workflow and command

syntax for the current task.

1. If the task shifts to SDK/in-app code, switch to the appropriate

SDK skill (e.g., cloud-functions, cloudbase-document-database-web-sdk) instead.

Routing

Quick workflow

1. tcb login → confirm envId with user → tcb env use <envId>
2. tcb <command> --help to verify syntax
3. Execute the command (with --dry-run for destructive ops)
4. Verify the result with the corresponding list / detail command
5. Report the outcome to the user

Minimum self-check

• [ ] Loaded references/core.md before any domain module?
• [ ] Confirmed target envId with the user?
• [ ] Used --help for unfamiliar commands?
• [ ] Used --dry-run before destructive operations?
• [ ] Verified the result after each operation?
• [ ] Stayed within CLI scope — did not drift into SDK code?

Reference index

All packaged reference files (required for skill lint reachability):

• access.md
• app.md
• cloudrun.md
• core.md
• functions.md
• hosting.md
• mysql.md
• nosql.md
• permission.md
• storage.md