triggershell/app/README.md

# TriggerShell web app

This directory is both the Next.js app and the home of the `triggershell` CLI (`bin/triggershell.js`
→ `src/cli`) that launches it — together they're published as one npm package. The app is still not
meant to be run standalone with `next dev`/`next start`, since it needs a custom server (`server.ts`)
for the WebSocket endpoint; use the CLI (`triggershell start`) or the `pnpm` scripts below instead.

See the [repo root README](../README.md) for how to run TriggerShell end-to-end, and
[`../docs/ARCHITECTURE.md`](../docs/ARCHITECTURE.md) for how this app is put together.

```bash
pnpm install
pnpm dev          # tsx watch server.ts - reads TRIGGERSHELL_CONFIG_PATH from the environment
pnpm lint
pnpm typecheck
pnpm test         # CLI unit tests (src/cli/**/*.test.ts)
pnpm db:studio    # browse the SQLite database
```

Note: this is the contributor workflow for developing TriggerShell itself. End users install and
run the published `triggershell` CLI instead (see the root README).