altllm-portal-cli

# AltLLM Portal CLI

Use this umbrella skill when working inside this repository and the task crosses multiple Portal domains. For focused requests, prefer one of the domain skills below.

AltLLM itself has two distinct surfaces that are easy to confuse:

- the **Portal API**, which manages auth, billing, API keys, and payment links
- the **OpenAI-compatible gateway**, which consumes Portal-issued API keys for model inference

This skill family is specifically about the **Portal CLI workflow** in this repository. Use it to operate the Portal side safely and consistently, not to document or proxy the gateway itself.

## Shared Setup

> Before the first `altllm` command in a fresh checkout, read and follow:
> - `../_shared/preflight.md`
> - `../_shared/session-and-target.md`

## Skill Map

| Skill | Purpose | Use When |
|---|---|---|
| `altllm-portal-auth` | Wallet login and session bootstrap | Wallet challenge, signature verification, login troubleshooting |
| `altllm-portal-api-keys` | Portal API key lifecycle | Create, inspect, disable, re-enable, or revoke API keys |
| `altllm-portal-billing` | Balance, promo, transactions, and usage analytics | Credit balance, promo redemption, billing history, usage views |
| `altllm-portal-payments` | NOWPayments link creation, polling, and direct payment execution | Crypto top-up links, payment status, direct wallet payment |
| `altllm-x402` | Portal x402 credit top-up guidance | BSC/USDT x402 quotes, discount top-ups, wallet signing, settlement, facilitator errors |

## Plan Awareness

- Personal tiers are `free`, `basic`, `pro`, and `power`; Business/Flex is `flex`.
- Use `credit` to inspect plan/model-access metadata returned by Portal, including `subscription_tier: "flex"` when present.
- Flex users can create API key allowlists with normal AltLLM model IDs and Flex-only `altllm-flex-*` IDs, subject to backend access checks.

## Working Rules

- Prefer the focused skill when the request stays within one domain.
- Use this umbrella skill when the workflow spans multiple domains, for example:
  - login -> create API key -> verify gateway use
  - credit -> transactions -> usage analytics
  - top-up -> payment-status -> pay-payment-link
  - x402 quote -> wallet signing -> settlement -> balance verification
- Keep implementation and docs aligned when behavior changes.

## Reference

See [references/skill-map.md](references/skill-map.md) for file ownership and command-to-skill mapping.