From boxel-cli
Manages boxel-cli profiles for different users and environments. Lists, adds, switches, removes profiles, and migrates from legacy .env files.
How this skill is triggered — by the user, by Claude, or both
Slash command
/boxel-cli:profileThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Wraps `boxel profile`, which manages credentials for different users and environments. Profiles live in `~/.boxel-cli/profiles.json` (mode 0600).
Wraps boxel profile, which manages credentials for different users and environments. Profiles live in ~/.boxel-cli/profiles.json (mode 0600).
| Ask | Run |
|---|---|
| "what profiles do I have?" / "who am I logged in as?" | boxel profile list |
| "log in" / "add a new account" | boxel profile add (interactive — preferred) |
| "switch to my staging account" | boxel profile switch <username-or-fragment> |
| "remove that old profile" | boxel profile remove <profile-id> |
| "import from my old .env" | boxel profile migrate |
Profiles use the Matrix ID format: @username:domain.
@username:boxel.ai@username:stack.cards@username:<env-slug>.localhostswitch accepts a partial match — boxel profile switch sarah is enough if there's only one profile matching sarah.
For automation, set BOXEL_PASSWORD in the environment instead of passing -p:
BOXEL_PASSWORD="..." boxel profile add -u @sarah:boxel.ai -n "Sarah - Prod"
-p works but exposes the password in shell history and process listings. Prefer BOXEL_PASSWORD.
For ephemeral environments (PR previews, branch deploys), BOXEL_ENVIRONMENT derives URLs from a slug:
BOXEL_ENVIRONMENT=my-branch boxel profile add -u @sarah:my-branch.localhost
# → matrix at http://matrix.my-branch.localhost
# → realm-server at http://realm-server.my-branch.localhost/
Override individually with --matrix-url / --realm-server-url if needed.
Generated from the boxel-cli Commander tree by pnpm build:plugin. Edit prose outside the generated block — never inside it.
boxel profile [subcommand] [arg]Manage saved profiles for different users/environments
Arguments:
[subcommand] — list | add | switch | remove | migrate[arg] — Profile ID (for switch/remove)Options:
-u, --user <matrixId> — Matrix user ID (e.g., @user:boxel.ai)-p, --password <password> — Password (for add command)-n, --name <displayName> — Display name (for add command)-m, --matrix-url <url> — Matrix server URL (for add command with non-standard domains)-r, --realm-server-url <url> — Realm server URL (for add command with non-standard domains)boxel profile list returns empty until boxel profile add is run at least once.migrate is a one-shot operation for users coming from the old .env storage. New users don't need it.npx claudepluginhub cardstack/boxel --plugin boxel-cliSync files between local disk and a Boxel realm using push, pull, bidirectional sync, or continuous watch. Also create, remove, and list realms.
Manages client profiles for the Ayrshare MCP server: create profiles, list them, and generate social-account linking URLs for client onboarding under a Business account.
Provides access to Clerk CLI for authentication, user/org/session management, deployment verification, environment keys, and Clerk API calls. Handles auth and formatting automatically.