@hasna/skills 0.1.31 → 0.1.33

package/README.md

@@ -19,6 +19,13 @@ Requires [Bun](https://bun.sh/) 1.0+.
 # Browse skills interactively
 skills
 
+# Hosted setup is the recommended interactive path
+skills setup --mode hosted
+skills auth login
+
+# Local-only setup stays available and does not require an account
+skills setup --mode local
+
 # Optionally pin a skill preference in this project
 skills pin image
 
@@ -28,8 +35,7 @@ skills setup agents
 # See what a skill needs
 skills info image
 
-# Premium skills run remotely through skills.md
-skills auth login
+# Premium skills run through the configured hosted API
 skills run image "a cat sitting on a windowsill"
 
 # Free/local skills can still use your own provider keys when documented
@@ -39,21 +45,25 @@ OPENAI_API_KEY=... skills run brand-style-guide ./brand-notes.md
 
 ## Remote-Only Premium Skills
 
-Premium skills are SaaS runs. The CLI and MCP server submit them to the
-skills.md API, create local run metadata, and then expose status and artifact
-commands. They do not fall back to bundled local execution when auth is missing
-or the platform is unavailable.
+Premium skills are hosted SaaS runs. The CLI and MCP server submit them to the
+configured hosted API, create local run metadata, and then expose status and
+artifact commands. They do not fall back to bundled local execution when auth is
+missing or the platform is unavailable.
 
 Use `SKILLS_API_KEY` or `skills auth login` for premium hosted execution:
 
 ```bash
+skills setup --mode hosted
 skills auth login
 skills run image "editorial product photo on a white sweep"
 skills runs status <run-id>
 skills exports download <run-id>
 ```
 
-`SKILLS_API_KEY` is the skills.md account credential. It is not a provider
+`skills auth login` uses browser/device-code auth by default. Email code login
+is still available with `skills auth login --email you@example.com`.
+
+`SKILLS_API_KEY` is the hosted account credential. It is not a provider
 credential. Provider keys such as `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or
 `GEMINI_API_KEY` remain supported only for free/local OSS skills whose
 requirements explicitly document local provider use.
@@ -67,6 +77,8 @@ requirements explicitly document local provider use.
 | `skills pin --category "Development Tools"` | | Pin all skills in a category |
 | `skills unpin <name>` | | Remove a project pin |
 | `skills pins list` | | List pinned skills |
+| `skills setup --mode hosted` | | Configure hosted mode with a compatible API origin |
+| `skills setup --mode local` | | Configure local-only mode without hosted credentials |
 | `skills setup agents` | | Register the Skills MCP server with all supported agents |
 | `skills list` | `ls` | List available skills (filter with `-c`, `--pinned`, `-t`, `--brief`) |
 | `skills search <query>` | `s` | Search by name, description, or tags |
@@ -84,7 +96,11 @@ requirements explicitly document local provider use.
 | `skills doctor` | | Check env vars, system deps, and pinned skill health |
 | `skills test [name]` | | Test skill readiness (env, system, npm deps) |
 | `skills outdated` | | Compare pinned vs registry versions |
-| `skills auth [name]` | | Show/set auth env vars in `.env` |
+| `skills auth login` | | Sign in to the hosted API with browser/device-code auth or email code |
+| `skills billing status` | | Show hosted account plan and balance |
+| `skills billing checkout` | | Create a hosted subscription checkout session |
+| `skills billing portal` | | Create a hosted customer portal session |
+| `skills credits buy <amount>` | | Create a hosted credit-pack checkout session |
 | `skills setup-info` | | Version, pinned skills, agent configs, paths |
 | `skills export` | | Export pinned skills as JSON |
 | `skills import <file>` | | Pin skills from a JSON export |
@@ -97,7 +113,6 @@ requirements explicitly document local provider use.
 | `skills schedule list` | | List all schedules (enabled/disabled/last run) |
 | `skills mcp` | | Start MCP server on stdio |
 | `skills mcp --register claude` | | Register the Skills MCP server in an agent config (also `codex`, `gemini`, `opencode`, `all`) |
-| `skills serve` | | Start the HTTP dashboard on localhost |
 | `skills self-update` | | Update this package to the latest version |
 | `skills completion <shell>` | | Generate shell completions (bash, zsh, fish) |
 
@@ -196,22 +211,17 @@ skills mcp --register claude    # Auto-register with Claude Code
 skills mcp --register all       # Register with all supported agents
 ```
 
-## Cloud Sync
+## Hosted Account
 
 ```bash
-cloud setup
-cloud sync push --service skills
-cloud sync pull --service skills
-```
-
-## Dashboard
-
-```bash
-skills serve              # Start HTTP server (opens browser automatically)
-skills serve --no-open    # Start without opening the browser
+skills setup --mode hosted
+skills auth login
+skills billing status
 ```
 
-Dashboard features: searchable/filterable skills table, detail dialogs, stats cards, dark/light/system theme, oklch color tokens.
+Hosted account, billing, and credit management use the configured hosted API.
+The public package only stores local configuration and CLI credentials; Stripe,
+customer records, and hosted execution remain platform concerns.
 
 ## Project Structure
 
@@ -219,7 +229,6 @@ Dashboard features: searchable/filterable skills table, detail dialogs, stats ca
 src/
 ├── cli/index.tsx           # Commander.js CLI + Ink TUI
 ├── mcp/index.ts            # MCP server (stdio) with ~20 tools
-├── server/serve.ts          # Bun.serve HTTP server + REST API
 ├── lib/
 │   ├── registry.ts          # 202+ entries, search, categories, tags
 │   ├── installer.ts         # Project pins and disabled source-copy paths
@@ -234,9 +243,7 @@ src/
 
 skills/                      # 202+ public skill contracts and local OSS skills
 ├── _common/                 # Shared utilities
-└── */                       # Local skills include src/; premium package output excludes private src/
-
-dashboard/                   # Next.js + React 19 + Tailwind v4 app
+└── */                       # Local skills include src/; hosted skills are metadata-only
 ```
 
 ## Project Runtime State
@@ -254,8 +261,8 @@ folders and agent-native skill folders are never used as skill libraries.
 └── tmp/
 ```
 
-Auth stays global in `~/.skills/auth.json`. Registry and doc caches belong in
-`~/.cache/skills` or the remote API, not inside project `.skills`.
+Auth stays global in `~/.hasna/skills/auth.json`. Registry and doc caches
+belong in `~/.cache/skills` or the remote API, not inside project `.skills`.
 
 ## Development
 
@@ -263,8 +270,6 @@ Auth stays global in `~/.skills/auth.json`. Registry and doc caches belong in
 bun install
 bun run build              # Build CLI, MCP, library, and types
 bun run dev                # Run CLI in dev mode (no build needed)
-bun run dashboard:dev       # Vite dev server for web dashboard
-bun run server:dev          # HTTP server with --watch
 bun test                   # Run all tests
 bun run typecheck          # TypeScript type checking
 ```
@@ -287,7 +292,7 @@ Project `.skills/` is reserved for runtime state and outputs.
 ## Data Directory
 
 Global configuration is stored in `~/.hasna/skills/`. Auth is stored in
-`~/.skills/auth.json`. Project runtime data is stored in `.skills/runs`,
+`~/.hasna/skills/auth.json`. Project runtime data is stored in `.skills/runs`,
 `.skills/exports`, `.skills/tmp`, and optional `.skills/project.json`.
 
 ## License