boxlite-setup
/boxlite-setup
Install a compatible BoxLite CLI and authenticate its developer cloud profile before deployment. Use for first-use BoxLite onboarding, missing CLI installation or expired BoxLite credentials, not an application's end-user login.
- Author
- boxlite-ai ↗
- Repository
- boxlite ↗
- Licence
- Apache-2.0
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 4
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
Install a compatible BoxLite CLI and authenticate its developer cloud profile before deployment. Use for first-use BoxLite onboarding, missing CLI installation or expired BoxLite credentials, not an application's end-user login.
Original author description
Install a compatible BoxLite CLI and authenticate its developer cloud profile before deployment. Use for first-use BoxLite onboarding, missing CLI installation or expired BoxLite credentials, not an application's end-user login.
How it works
- 1. Select a compatible CLI
- 2. Authenticate the selected profile
- 3. Verify routing and continue
SKILL.md preview
---
name: boxlite-setup
description: Install a compatible BoxLite CLI and authenticate its developer cloud profile before deployment. Use for first-use BoxLite onboarding, missing CLI installation or expired BoxLite credentials, not an application's end-user login.
---
Run this workflow when the user starts BoxLite setup or first asks the bundled **boxlite** skill to build/deploy an app. Continue from the original app request after setup; do not require the user to find a Setup button or invoke another skill manually. Reuse a verified CLI and valid selected profile; installation alone does not start authentication.
## 1. Select a compatible CLI
~~~sh
command -v boxlite
boxlite --version
boxlite auth login --help
boxlite network tunnel --help
~~~
Expect: a verified official **v0.10.6+** CLI, or the provenance-verified pinned native build in [source-build](references/source-build.md), with device login and tunnels. Published v0.10.5 lacks the hosted device-endpoint fix; the pinned build may report v0.10.5 and is identified by source provenance.
If no CLI is installed, check the official release version. When a compatible release exists, set CLI_TAG to that published v0.10.6+ tag. Download its official installer into a temporary directory, verify checksum and provenance, then execute it:
~~~sh
INSTALLER_DIR="$(mktemp -d)"
(
set -eu
cd "$INSTALLER_DIR"
gh release download "$CLI_TAG" --repo boxlite-ai/boxlite --pattern install.sh --pattern install.sh.sha256
if command -v sha256sum >/dev/null 2>&1; then
sha256sum -c install.sh.sha256
else
shasum -a 256 -c install.sh.sha256
fi
XDG_CACHE_HOME="$INSTALLER_DIR/cache" gh attestation verify install.sh --repo boxlite-ai/boxlite
BOXLITE_VERSION="$CLI_TAG" sh ./install.sh
)
"$HOME/.local/bin/boxlite" --version
~~~
Checksum and attestation must both pass before execution. If gh, verification or a compatible release is unavailable, use the pinned source procedure; never bypass verification.
Expect: a compatible binary under ~/.local/bin. Retain its absolute path when PATH does not persist across tool calls. If no compatible release exists or an installed CLI is incompatible, execute the supported pinned source procedure and continue login. Give the user any administrator/interactive dependency step that requires their participation.
Use local CLI help and bundled instructions first. Online docs are only for missing information or current release verification; fetch failure does not block a verified executable or the source procedure.
## 2. Authenticate the selected profile
Respect the selected home, API and profile. If no profile was specified, inspect `boxlite auth status` and reuse the active profile; choose a named cloud profile only when no existing context applies. Use the CLI global `--home CLI_HOME` selector for a custom BoxLite home; this is not the operating system HOME. Check the reported credential source without displaying its value. In the examples, substitute the selected API/home, or omit a selector only when intentionally using its verified default.
~~~sh
boxlite --home CLI_HOME --profile PROFILE --url API auth status
boxlite --home CLI_HOME --profile PROFILE --url API auth whoami
~~~
Expect: online identity for the intended API. A successful check skips login. Missing credentials or an expired session that cannot refresh: read [login](references/login.md) and start the appropriate device command automatically, using its production mapping only for the matching API/issuer. Present the verification URL/user code and keep polling alive while the user authorizes in the browser.
DNS, TLS, transport, rate-limit or server failures are not proof that credentials expired: report the failing connection and preserve the profile instead of opening another login. Stop on denial/cancellation/expiry; do not retry authorization or change accounts to bypass the result. Browser PKCE and user-controlled API-key alternatives are in the login reference.
## 3. Verify routing and continue
~~~sh
boxlite --home CLI_HOME --profile PROFILE --url API auth whoami
boxlite --home CLI_HOME --profile PROFILE --url API list --format json
~~~
Expect: online identity and cloud resources using the same connection settings. Keep credentials private; never print the store or request tokens in chat. Return the verified executable/home/profile/API to the original **boxlite** workflow and continue the requested app task. A login-only request ends after these checks. Installation/discovery does not prove login or deployment.
Files in this package (4)
- SKILL.md 4 KB
- agents/openai.yaml 1 KB
- references/login.md 3 KB
- references/source-build.md 6 KB
Versions
The database has no other skills named boxlite-setup.
Database snapshot: 13.11.2026 · package version 8a6f5f2fb96e (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95boxlite
Build or adapt an application, deploy it to BoxLite cloud, return its registered public HTTPS URL, and update or diagnose it. Use for BoxLite hosting requests and app building that explicitly selects BoxLite. - 100signing-in-to-aws
Gets AWS credentials for CLI/SDK access via `aws login`. Activates when a developer needs to authenticate to AWS for local development, when an AWS operation fails due to missing or expired credentials, or when someone asks about setting up AWS access. Triggers: "set up AWS",… - 100gcloud-setup
Install and authenticate the Google Cloud CLI (gcloud, gsutil, bq) on macOS. Use when the user needs to set up gcloud from scratch, re-authenticate, add OAuth scopes for a specific Google API (Search Console, Drive, Sheets, etc.), or fix Application Default Credentials (ADC) issues. - 90setup
Get this machine ready to deploy on Gagarin Cloud — install the gg CLI if it is missing, sign in, and check the rest of the toolchain (docker, git, gh or glab). Use when the user asks to set up, install or configure Gagarin, or when gg is not found. - 100aws
Expert AWS CLI guidance. Use when the task involves aws commands or the AWS CLI — installing, updating, or pinning AWS CLI v2 (and migrating scripts off the end-of-support v1), authentication issues ("Unable to locate credentials", "ExpiredToken", "The SSO session has expired",…