@secondlayer/sentinel 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ryan Waits
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# @secondlayer/sentinel
+
+Sentinel from a terminal or an agent. Paste a contract, get a monitoring plan, tune what is watched, read alerts. No bun, no repo: Node 22 or newer.
+
+```sh
+npm i -g @secondlayer/sentinel
+sentinel login
+sentinel plans
+```
+
+`sentinel login` signs in with your secondlayer account: your email, then a 6-digit code. It shares `~/.secondlayer/session.json` with the secondlayer CLI, so either login serves both. Open runsentinel.app once first if you have never used Sentinel.
+
+For CI, pipe a key from the web app (API keys): `echo "$KEY" | sentinel login --with-token`, or set `SENTINEL_API_KEY`. Order: `SENTINEL_API_KEY`, `--token`, saved key, saved login.
+
+## CLI
+
+```sh
+sentinel new SP….vault          # what it would plan and cost; add --yes to start
+sentinel plans                  # your contracts, monitoring, worst evidence
+sentinel watches <plan>         # what is watched
+sentinel alerts                 # newest first
+sentinel balance                # balance and prices
+sentinel --help                 # everything else
+```
+
+Anything that spends balance or changes monitoring shows what it would do first and only happens with `--yes`.
+
+## MCP
+
+```sh
+claude mcp add sentinel -- npx -y -p @secondlayer/sentinel sentinel-mcp
+```
+
+Uses your login, or add `--env SENTINEL_API_KEY=sk-sl_…` for a scoped key. Every write tool takes `confirm`; without it you get what would happen and nothing changes.
+
+## SDK
+
+```ts
+import { createClient, resolveToken } from "@secondlayer/sentinel";
+
+const credential = await resolveToken();
+const sentinel = createClient({ token: credential?.token ?? "" });
+console.log(await sentinel.plans());
+```
+
+Ownership proof, claiming, billing top-ups and key creation stay in the web app.