Interactive CLI Setup Wizard (npx @shdwsdk/sdk init / npx shdw-init)
Getting Started & SDK
#cli#init#npx#shdw-init#wizard#env#boilerplate#connectivity
Configure .env / .env.local, generate a ready-to-use AI client wrapper (src/lib/shdw.ts), and verify live telemetry connectivity in under 60 seconds.
How It Works Under the Hood
- •Prompts interactively in your terminal for your SHDW API key (shdw_live_*), primary cloud data center region (22 EU/US/APAC/LATAM grids), and primary AI model (11 featured models; any model id works).
- •Safely detects .env.local (or .env) and upserts SHDW_API_KEY and SHDW_GRID_REGION without modifying or overwriting any unrelated environment variables or comments.
- •Generates a provider-tailored boilerplate file (default: src/lib/shdw.ts) pre-wired with ShdwTelemetryClient and shdw.wrapClient(), then sends a 1500ms-guarded validation ping to confirm your API key and network route.
How to Use It Step-by-Step
- 1Open your terminal in your project's root directory (Windows PowerShell, macOS Terminal, or Linux bash).
- 2Run `npx @shdwsdk/sdk init` (or `npx shdw-init`) and follow the 4 prompts.
- 3Import your wrapped AI client from `src/lib/shdw.ts` anywhere in your application.
Terminal — Interactive & Flag-Based Setup
# Interactive setup wizard npx @shdwsdk/sdk init # Or run directly with flags npx shdw-init --api-key shdw_live_xxx --region eu-west-3 --model claude-sonnet-5-5 --out src/lib/shdw.ts
Related guides
- Non-Blocking Client Wrapper (shdw.wrapClient) & Fail-Silent Guarantee
- Layer 1: Zero-Touch Runtime AI-BOM Auto-Discovery & Zero-Knowledge Prompt Hashing
- Layer 2: RAG & Vector Database Auto-Instrumentation (shdw.wrapVectorStore)
- Layer 3: Static Manifest & CI/CD Auto-Scanner (@shdwsdk/sdk/scanner)
- Layer 4: Model Integrity & CycloneDX / SPDX Exporters
- Scope 3 Energy & Carbon Formula + 22 Global & European Data Center Regions
- EU AI Act Risk Classification & US NIST AI RMF 1.0 Assessment Matrix
- Buyer-Facing Public Trust Center (/trust/[slug]) & Embeddable HTML Badge
