Registry / devops / sentinelayer-cli

sentinelayer-cli

library0.8.11jsnpmunverified

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.

devops auth-security http-networking

npm install sentinelayer-cli

github ↗package ↗

INSTALL

IMPORT

SIG · SENTINELAYER-CLI

sentinelayer-cli

devopsjavascriptv0.8.11

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (CLI execution)

✓ npx sentinelayer-cli@latest <project-name>

✗ npx create-sentinelayer (works as alias but may not match docs exactly)

Primary invocation via npx. The package is a CLI, not a library, so imports are not typical. Use npx or global install.

programmatic usage (Node.js API)

✓ import { scaffold } from 'sentinelayer-cli'; // hypothetical – check current API

✗ import { sentinelayer } from 'sentinelayer-cli'

No documented programmatic API in v0.8.x. The package is CLI-only. Future versions may expose a library.

CommonJS require (not supported)

✓ not supported – use npx or global install

✗ const sentinelayer = require('sentinelayer-cli')

Package is CLI-only and may not export a module. Use npx or install globally.

Scaffold a new project with sentinelayer-cli in interactive mode, then use non-interactive with environment variable for automation.

npx sentinelayer-cli@latest my-app # Or with non-interactive JSON: SENTINELAYER_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}' \ npx sentinelayer-cli@latest demo --non-interactive --skip-browser-open

sentinelayer-cli --version

Debug

Known issues

breakingWindows PowerShell 'sl' alias conflicts with built-in Set-Location. Using 'sl' will run Set-Location instead of sentinelayer-cli.

fix

Use 'sentinelayer-cli' or 'slc' alias instead of 'sl' on Windows PowerShell.

affects: >=0.0.0

breakingNode.js engine requirement: ^20.0.0 || ^22.0.0. Older versions (e.g. 18.x) are unsupported and may throw engine check errors.

fix

Upgrade Node.js to v20 or v22, or use npx with an explicit Node version manager.

affects: >=0.4.0

deprecatedLegacy binary 'create-sentinelayer' may be removed in future versions; use 'sentinelayer-cli' primary binary.

fix

Switch to 'npx sentinelayer-cli@latest' instead of 'npx create-sentinelayer'.

affects: >=0.4.0

gotchaIn non-interactive mode, both SENTINELAYER_CLI_INTERVIEW_JSON and --non-interactive are required; missing either reverts to interactive prompts.

fix

Set the environment variable and pass the --non-interactive flag. Also use --skip-browser-open in headless CI.

affects: >=0.4.0

gotchaToken injection to GitHub Actions secrets requires 'gh' CLI installed and authenticated. May fail silently if gh is missing.

fix

Ensure GitHub CLI (gh) is installed and logged in (gh auth login) before running with injectSecret:true.

affects: >=0.4.0

breakingAgent 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.

fix

Upgrade to v0.8.11 or later. The fix added process-local tracking and flush handlers.

affects: <0.8.11

Errors

Common errors & fixes

Error: 'sl' is not recognized as an internal or external command, operable program or batch file.

On Windows, 'sl' is a built-in PowerShell alias for Set-Location. Running 'sl' from cmd.exe or PowerShell with the alias may fail.

fix

Use 'sentinelayer-cli' or 'slc' instead of 'sl' on Windows. Or run 'sl' in a context where the package's binary is preferred.

Error: The engine "node" is incompatible with this module. Expected version "^20.0.0 || ^22.0.0". Got "18.x.x"

Node.js version is too old. Package requires Node.js >=20.0.0 or >=22.0.0.

fix

Upgrade Node.js using nvm, fnm, or download from nodejs.org. Run: nvm install 20.

Error: Non-interactive mode requires SENTINELAYER_CLI_INTERVIEW_JSON environment variable to be set.

The --non-interactive flag was provided but the environment variable is missing.

fix

Set SENTINELAYER_CLI_INTERVIEW_JSON with a valid JSON string before running the command.

Error: Failed to open browser for auth. Could not find browser.

The CLI tries to open a browser for auth but cannot detect one in the environment (e.g., headless CI).

fix

Use --skip-browser-open flag when running in headless CI. If managed auth needed, ensure a browser is available or use BYOK mode.

Error: GitHub CLI not found. Please install 'gh' and login.

The injectSecret feature requires gh CLI to set secrets, but it's not installed.

fix

Install GitHub CLI from https://cli.github.com/ and authenticate with 'gh auth login'.

Upgrade

Version history

0.8.11latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

19 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/mrrCarter/create-sentinelayer ↗

packagehttps://www.npmjs.com/package/sentinelayer-cli ↗