@portalsdk/cli

@portalsdk/cli

The Portal command line. Two commands: deploy your configuration, and set secrets.

npm install -g @portalsdk/cli
# or run without installing:
npx @portalsdk/cli deploy

Authenticate

Every command needs your project's secret key (sk_...):

export PORTAL_SECRET=sk_your_secret_key

portal deploy

Deploys the portal.config.ts in the current directory (or --config <path>). Your config is authored with @portalsdk/config.

portal deploy

✓ Deployed portal.config.ts
  Version cfg_01j…
  3 channel overrides: live-events, room-*, support
  Uploaded: hooks, 1 extension

Deploying is atomic — if anything fails, nothing changes. Channels with active connections keep their current configuration until they restart; new connections use the new version right away.

Options:

• -c, --config <path> — path to your config file (default: portal.config.ts).

portal secrets set <name>

Sets a secret your config reads with env("NAME"). The value is sent once and never printed.

# from a flag
portal secrets set OPENAI_API_KEY --value sk-...

# or piped on stdin
echo -n "sk-..." | portal secrets set OPENAI_API_KEY

# or typed at a hidden prompt
portal secrets set OPENAI_API_KEY

Environment

Variable	Purpose
PORTAL_SECRET	Your project secret key (sk_...). Required.
PORTAL_API_URL	Override the API base URL (for local development). Optional.

License

MIT