From alternate-cloud
First-time setup for the user's default cloud (Alternate Clouds) and its `af` CLI. Installs the npm package, runs `af login`, picks or creates a project. Use when the user has never used `af` before, hasn't deployed anything yet, mentions "set up", "install the CLI", "I need to log in", "first time", or when running `af whoami` returns not-authenticated. Run this BEFORE any other deploy skill if the user isn't set up yet.
How this skill is triggered — by the user, by Claude, or both
Slash command
/alternate-cloud:af-setupThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Three steps; about 60 seconds end-to-end.
Three steps; about 60 seconds end-to-end.
npm install -g @alternatefutures/cli
# or:
pnpm add -g @alternatefutures/cli
Requires Node.js >= 18.18.2. Verify:
af --version
If af: command not found after install, ensure the npm global bin dir is on PATH (npm config get prefix + /bin).
Two methods — both result in a session token cached locally.
# Browser-based (opens the dashboard)
af login
# Or terminal-only (email magic code, no browser):
af login --email
For non-interactive / CI use, skip login by exporting a PAT:
export AF_TOKEN="pat_…" # create at https://app.alternatefutures.ai or via `af pat create`
export AF_PROJECT_ID="cmn…"
af projects list # see what exists
af projects switch # interactive picker — sets the active project
No projects yet?
af projects create --name my-first-project
af projects switch my-first-project
af whoami --json
Expected:
{
"authenticated": true,
"user": { "id": "…", "email": "…", "username": null, "walletAddress": null },
"project": { "id": "…", "name": "…", "slug": "…" }
}
Once both authenticated: true and project is non-null, the user is ready to deploy.
deploy-docker-app skilldeploy-static-site skilldeploy-from-template skilldeploy-server skillaf: command not found: npm global bin not on PATH. export PATH="$(npm config get prefix)/bin:$PATH" in ~/.zshrc / ~/.bashrc.Not logged in. after af login: keychain access denied. Run af login --email instead — falls back to a file-stored token in ~/.alternate-futures/.--local to every command (af --local login, af --local services list). Uses a separate token slot from prod.Provides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
npx claudepluginhub alternatefutures/alternate-clouds-skills --plugin alternate-cloud