{"id":18824,"library":"stellate","title":"Stellate CLI","description":"The official command-line tool for managing Stellate GraphQL edge caching services. Version 3.2.13, requires Node.js ^24.13.0 and pnpm ^9.15.0. Provides commands for authentication (login), service setup (init), config synchronization (pull, push), schema validation (check, subset), local development (serve), and listing apps (ls). Key differentiator: full lifecycle management of Stellate services from the terminal, with automatic API token handling stored in ~/.stellate. TypeScript types included.","status":"active","version":"3.2.13","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","typescript"],"install":[{"cmd":"npm install stellate","lang":"bash","label":"npm"},{"cmd":"yarn add stellate","lang":"bash","label":"yarn"},{"cmd":"pnpm add stellate","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"The package exports a named class, not a default export. TypeScript types are bundled.","wrong":"import Stellate from 'stellate'","symbol":"Stellate","correct":"import { Stellate } from 'stellate'"},{"note":"ESM-only package; require() will fail. Use dynamic import if needed.","wrong":"const runStellate = require('stellate')","symbol":"runStellate","correct":"import { runStellate } from 'stellate'"},{"note":"Type-only import for TypeScript users. Importing as value will cause runtime error.","wrong":"","symbol":"StellateConfig","correct":"import type { StellateConfig } from 'stellate'"}],"quickstart":{"code":"import { Stellate } from 'stellate';\n\nconst stellate = new Stellate({ apiKey: process.env.STELLATE_API_KEY ?? '' });\n\nasync function listServices() {\n  const services = await stellate.list();\n  console.log(services);\n}\n\nlistServices().catch(console.error);","lang":"typescript","description":"Initializes the Stellate client with an API key and lists all services."},"warnings":[{"fix":"Update Node.js to version 24.13.0 or higher (matching the engine requirement). Older versions will not work.","message":"Node.js version requirement: ^24.13.0","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Install pnpm globally (`npm i -g pnpm`) and use `pnpm install` to set up dependencies.","message":"pnpm is required as the package manager; yarn and npm may cause issues with workspace linking.","severity":"gotcha","affected_versions":">=3.0.0"},{"fix":"Use with caution in CI; monitor Stellate changelog for updates.","message":"The 'check' command is marked as BETA and may have breaking changes or be removed in future versions.","severity":"deprecated","affected_versions":">=3.0.0"},{"fix":"Always verify which token file is being used when switching environments. Re-run `login` if needed.","message":"Authentication tokens are stored in ~/.stellate directory. Changing the STELLATE_ENDPOINT environment variable will use a different token file, which may cause confusion if you forget to re-authenticate.","severity":"gotcha","affected_versions":">=3.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run `pnpm add stellate` in your project directory, then ensure your import uses `import { Stellate } from 'stellate'`.","cause":"Package not installed or import path incorrect.","error":"Error: Cannot find module 'stellate'"},{"fix":"Replace `import Stellate from 'stellate'` with `import { Stellate } from 'stellate'`.","cause":"Default import used instead of named import.","error":"TypeError: stellate_1.Stellate is not a constructor"},{"fix":"Upgrade Node.js to version 24.13.0 or higher. Use `nvm` or download from nodejs.org.","cause":"Node.js version is lower than 24.13.0.","error":"Error: The engine 'node' is incompatible with this module. Expected version '^24.13.0'"},{"fix":"Set the `STELLATE_API_KEY` environment variable with a valid API token, or run `stellate login` interactively.","cause":"Running in a non-interactive environment without a preconfigured token.","error":"Error: Could not authenticate. No API token found and interactive login not available."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}