CLI reference

These are public @hasna/skills customer commands. skills.md is the CLI's default server, so signing in once is enough; later commands use that account. Self-hosted instances sign in with their own URL.

skills login

Self-hosted server

skills login --url https://<your-host>

Account and billing

Command after `skills`	Purpose
`login`	Sign in to skills.md, or to your own server with `--url https://<your-host>`.
`whoami`	Read the signed-in identity.
`logout`	Sign out and clear saved credentials on this machine.
`billing status --json`	Read plan and credit balance.
`billing usage --json`	Read usage history.
`billing invoices --json`	Read invoice history.
`billing checkout --json`	Create a subscription checkout link when enabled.
`billing portal --json`	Create a customer portal link.
`credits packs --json`	List available fixed pack IDs.
`credits buy <pack-id> --json`	Create checkout for an ID from the pack list.

API key management requires a fresh email/code reauthentication through auth keys list, auth keys create or auth keys revoke. An ordinary saved API key cannot grant itself key-management authority. Checkout links require the customer's browser payment confirmation.

Hosted work

Capabilities

skills capabilities --json

Catalog

skills list --remote --json

Quote

skills quote --json blog-article --topic "Your article topic"

Run

skills run --remote --yes --wait --json blog-article --topic "Your article topic"

Use runs status, runs logs, runs artifacts, runs cancel or runs resume followed by the run ID and --json. Resume and cancellation may be refused in the current state. exports download <run-id> --json verifies and writes artifacts. Uploads require the server's advertised capability; run --file <path> attaches files when supported.

--yes approves the server quote as a bounded credit maximum. Put all run flags before the skill name. --idempotency-key <key> safely retries an identical submission. Unsupported hosted features return an explicit error; they do not fabricate a successful empty result or fall back to local data.

For local discovery, pins, scaffolding, schedules and MCP host registration, consult the public package's help and documentation. This private product's diagnostic commands are not customer CLI commands.