supacloud
v0.5.4
Published
Unified entrypoint: `supacloudctl cli` and `supacloudctl admin` in one command
Maintainers
Readme
supacloud
Unified entrypoint that bundles both SupaCloud CLIs behind a single supacloudctl command.
supacloudctl cli → @supacloud/cli (project-scoped developer tools)
supacloudctl admin → @supacloud/admin (platform operations: install / SSH / tenant management)安装
npm install -g supacloud
supacloudctl --helpOne-off execution:
npx --package supacloud supacloudctl cli status
npx --package supacloud supacloudctl admin statussupacloud depends on both @supacloud/cli and @supacloud/admin, so installing
it gives you the full toolset. You can still install either CLI on its own
(@supacloud/cli exposes supacloud-cli, @supacloud/admin exposes supacloud-admin).
更新提示
supacloudctl cli ... and supacloudctl admin ... check the npm latest dist-tag before dispatch.
When a newer package exists, the dispatcher prints an update notice but still runs the dependency
version bundled with the installed supacloud package. It never downloads or executes a newer
operator CLI implicitly.
Disable the latest check when you need a pinned local version:
SUPACLOUD_NO_AUTO_UPDATE=1 supacloudctl cli status
# or
SUPACLOUD_AUTO_UPDATE=0 supacloudctl admin statusUse SUPACLOUD_NPM_REGISTRY or npm_config_registry to point the check at a registry mirror.
用法
supacloudctl cli status
supacloudctl cli project get
supacloudctl cli gateway routes --ref <ref>
supacloudctl admin status
supacloudctl admin project list
supacloudctl admin ssh pingEach subcommand accepts its own --help:
supacloudctl cli --help
supacloudctl admin --help上下文
supacloudctl cli auto-links the current project from .env:
SUPABASE_URL/SUPACLOUD_API_URLSUPABASE_SERVICE_ROLE_KEY/SUPACLOUD_API_TOKEN
supacloudctl admin expects platform context:
SUPACLOUD_HOST+SUPACLOUD_SSH_KEY/SUPACLOUD_SSH_PASSSUPACLOUD_API_URL+SUPACLOUD_API_TOKEN
Note:
/usr/local/bin/supacloudis the compiled management-api server binary. This npm package exposes onlysupacloudctl; it does not install asupacloudcompatibility alias and should normally be used on an operator's local machine.
