{"id":22350,"library":"sentinelayer-cli","title":"sentinelayer-cli","description":"CLI tool for scaffolding Sentinelayer spec/prompt/guide artifacts and bootstrapping SENTINELAYER_TOKEN via browser auth. Current stable version 0.8.11. Release cadence is high (multiple releases per week). Key differentiators: non-interactive CI mode, BYOK token mode, GitHub auth integration, and multi-command support (auth, scan, omargate, audit). Requires Node.js ^20.0.0 or ^22.0.0. Compatible with Windows via 'sentinelayer-cli' binary due to 'sl' alias conflict with PowerShell's Set-Location. Includes compatibility aliases: create-sentinelayer, sentinel, sl.","status":"active","version":"0.8.11","language":"javascript","source_language":"en","source_url":"https://github.com/mrrCarter/create-sentinelayer","tags":["javascript","sentinelayer","sentinelayer-cli","omar-gate","security","scaffold","cli"],"install":[{"cmd":"npm install sentinelayer-cli","lang":"bash","label":"npm"},{"cmd":"yarn add sentinelayer-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add sentinelayer-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Primary invocation via npx. The package is a CLI, not a library, so imports are not typical. Use npx or global install.","wrong":"npx create-sentinelayer (works as alias but may not match docs exactly)","symbol":"default (CLI execution)","correct":"npx sentinelayer-cli@latest <project-name>"},{"note":"No documented programmatic API in v0.8.x. The package is CLI-only. Future versions may expose a library.","wrong":"import { sentinelayer } from 'sentinelayer-cli'","symbol":"programmatic usage (Node.js API)","correct":"import { scaffold } from 'sentinelayer-cli'; // hypothetical – check current API"},{"note":"Package is CLI-only and may not export a module. Use npx or install globally.","wrong":"const sentinelayer = require('sentinelayer-cli')","symbol":"CommonJS require (not supported)","correct":"not supported – use npx or global install"}],"quickstart":{"code":"npx sentinelayer-cli@latest my-app\n# Or with non-interactive JSON:\nSENTINELAYER_CLI_INTERVIEW_JSON='{\"projectName\":\"demo\",\"projectDescription\":\"Secure code review bot\",\"aiProvider\":\"openai\",\"codingAgent\":\"copilot\",\"authMode\":\"byok\",\"generationMode\":\"detailed\",\"audienceLevel\":\"developer\",\"projectType\":\"greenfield\",\"techStack\":[\"TypeScript\",\"Node.js\"],\"features\":[\"auth\"],\"connectRepo\":false,\"injectSecret\":false}' \\\n  npx sentinelayer-cli@latest demo --non-interactive --skip-browser-open","lang":"javascript","description":"Scaffold a new project with sentinelayer-cli in interactive mode, then use non-interactive with environment variable for automation."},"warnings":[{"fix":"Use 'sentinelayer-cli' or 'slc' alias instead of 'sl' on Windows PowerShell.","message":"Windows PowerShell 'sl' alias conflicts with built-in Set-Location. Using 'sl' will run Set-Location instead of sentinelayer-cli.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Upgrade Node.js to v20 or v22, or use npx with an explicit Node version manager.","message":"Node.js engine requirement: ^20.0.0 || ^22.0.0. Older versions (e.g. 18.x) are unsupported and may throw engine check errors.","severity":"breaking","affected_versions":">=0.4.0"},{"fix":"Switch to 'npx sentinelayer-cli@latest' instead of 'npx create-sentinelayer'.","message":"Legacy binary 'create-sentinelayer' may be removed in future versions; use 'sentinelayer-cli' primary binary.","severity":"deprecated","affected_versions":">=0.4.0"},{"fix":"Set the environment variable and pass the --non-interactive flag. Also use --skip-browser-open in headless CI.","message":"In non-interactive mode, both SENTINELAYER_CLI_INTERVIEW_JSON and --non-interactive are required; missing either reverts to interactive prompts.","severity":"gotcha","affected_versions":">=0.4.0"},{"fix":"Ensure GitHub CLI (gh) is installed and logged in (gh auth login) before running with injectSecret:true.","message":"Token injection to GitHub Actions secrets requires 'gh' CLI installed and authenticated. May fail silently if gh is missing.","severity":"gotcha","affected_versions":">=0.4.0"},{"fix":"Upgrade to v0.8.11 or later. The fix added process-local tracking and flush handlers.","message":"Agent leave events: prior to v0.8.11, CLI processes exiting via SIGINT/SIGTERM/crash did not emit 'agent_leave', causing dashboard to show stale agents as active.","severity":"breaking","affected_versions":"<0.8.11"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use 'sentinelayer-cli' or 'slc' instead of 'sl' on Windows. Or run 'sl' in a context where the package's binary is preferred.","cause":"On Windows, 'sl' is a built-in PowerShell alias for Set-Location. Running 'sl' from cmd.exe or PowerShell with the alias may fail.","error":"Error: 'sl' is not recognized as an internal or external command, operable program or batch file."},{"fix":"Upgrade Node.js using nvm, fnm, or download from nodejs.org. Run: nvm install 20.","cause":"Node.js version is too old. Package requires Node.js >=20.0.0 or >=22.0.0.","error":"Error: The engine \"node\" is incompatible with this module. Expected version \"^20.0.0 || ^22.0.0\". Got \"18.x.x\""},{"fix":"Set SENTINELAYER_CLI_INTERVIEW_JSON with a valid JSON string before running the command.","cause":"The --non-interactive flag was provided but the environment variable is missing.","error":"Error: Non-interactive mode requires SENTINELAYER_CLI_INTERVIEW_JSON environment variable to be set."},{"fix":"Use --skip-browser-open flag when running in headless CI. If managed auth needed, ensure a browser is available or use BYOK mode.","cause":"The CLI tries to open a browser for auth but cannot detect one in the environment (e.g., headless CI).","error":"Error: Failed to open browser for auth. Could not find browser."},{"fix":"Install GitHub CLI from https://cli.github.com/ and authenticate with 'gh auth login'.","cause":"The injectSecret feature requires gh CLI to set secrets, but it's not installed.","error":"Error: GitHub CLI not found. Please install 'gh' and login."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}