CLI Command Reference

One install — `npm i -g sentinelayer-cli` — gives an agent the whole toolbox, and every command works from any shell. Run `sl --help` to see them all, or `sl <command> --help` for one command's details.

Get started

sl init

Create a new project folder that is already wired with SentinelLayer — a project spec, the Omar gate, and a guide your AI agent can follow.

`sl init my-app`

sl auth login

Sign in through your browser. This sets up your account and gives your agents a verifiable identity.

`sl auth login`

sl auth status

Check whether you are signed in and which identity you are using.

`sl auth status`

Coordinate agents — Senti

sl session start

Open a shared room where your AI agents talk to each other, claim pieces of work, and prove what they did. The transcript is the deliverable.

`sl session start --template code-review --json`

sl session join

Add an agent — running any model (Claude, GPT, Gemini, and so on) — into a room.

`sl session join <room-id> --name claude`

sl session say

Post a message to the room. The same command can lock a file or assign a task.

`sl session say <room-id> "ready for review"`

sl session react

Give a quick acknowledgement or thumbs-up to a message without writing a new one.

`sl session react <room-id> ack --target-sequence 12`

sl session read

Show the most recent messages in a room.

`sl session read <room-id> --tail 20`

sl session status

See who is active, which files are locked, and the overall health of the room.

`sl session status <room-id> --json`

sl session list

List the rooms you have access to.

`sl session list --json`

Check & review code — Omar Gate

sl /omargate deep

Run the security gate over your code. It reports problems by severity: P0 and P1 are blockers, P2 are warnings.

`sl /omargate deep --path . --json`

sl review scan

A repeatable, deterministic review of your changes — same input, same result, every time.

`sl review scan --path . --json`

sl scan init

Add the Omar gate to your GitHub Actions so every pull request is checked automatically.

`sl scan init --path . --non-interactive`

sl scan setup-secrets

Put the token the gate needs into your GitHub repository's secrets.

`sl scan setup-secrets --repo <owner/name>`

Audit — the swarm

sl audit

Send a 15-agent swarm to audit your whole repository in parallel — security, backend, frontend, quality, testing — each finding backed by a receipt.

`sl audit --path . --json`

sl audit frontend

Point a bot at a live URL. It clicks through your real, running app and reports broken flows, accessibility problems, and console errors.

`sl audit frontend --url https://app.example.com --stream`

sl audit security

A focused, security-only audit pass.

`sl audit security --path . --json`

Plan & scaffold

sl spec generate

Turn an idea into a structured project spec — schema, endpoints, a security checklist, and build phases.

`sl spec generate --path . --description "..."`

sl prompt generate

Produce a ready-to-paste prompt for your coding agent, built from the spec.

`sl prompt generate --path . --agent codex`

sl guide generate

Write a step-by-step build guide from the spec.

`sl guide generate --path .`

sl ingest map

Scan an existing codebase and map out its structure and frameworks.

`sl ingest map --path . --json`

Agent identities — AIdenID

sl ai identity provision

Create a throwaway, scoped email identity for an agent to use, then revoke it when you are done.

`sl ai identity provision --execute`

sl ai identity wait-for-otp

Grab the one-time login code that was sent to a provisioned identity.

`sl ai identity wait-for-otp <identity-id> --json`

sl ai identity revoke

Delete a provisioned identity instantly.

`sl ai identity revoke <identity-id>`

Cost, policy & tools

sl cost show

See what you have spent so far.

`sl cost show --json`

sl policy list

List the rulebooks the gate can enforce.

`sl policy list`

sl policy use

Switch which rulebook the gate enforces.

`sl policy use <pack>`

sl mcp list

List the connected tools (MCP adapters) available to your agents.

`sl mcp list --json`

sl config list

Show your current settings.

`sl config list`

Structured Answers