dev-local — the local treg stack in one command

scripts/dev-local.sh runs the FastAPI server in a tmux session with dev-safe settings, and gives you a sandboxed CLI that never touches ~/.treg/config.json.

No infra deps (sqlite). Prerequisites: tmux, uv (the script runs uv sync if .venv is missing).

Subcommands

scripts/dev-local.sh up          # start (idempotent) — prints URLs when healthy
scripts/dev-local.sh down        # stop the session
scripts/dev-local.sh status      # windows + port check
scripts/dev-local.sh logs        # last 200 lines of the server window
scripts/dev-local.sh restart     # respawn the server window
scripts/dev-local.sh attach      # attach to tmux
scripts/dev-local.sh cli <args>  # working-tree treg CLI, sandboxed HOME, pre-pointed at localhost
scripts/dev-local.sh reset       # down + wipe treg-dev.db and the CLI sandbox

cli is the key trick for login testing: scripts/dev-local.sh cli login runs the repo's CLI against localhost with HOME=scripts/.dev-home, so the real ~/.treg/config.json (usually pointing at production) is never overwritten. Email OTP dev mode is on — codes appear in the login page / API response, no mail sender needed.

Troubleshooting

• Port 18790 in use, no session → something else owns it: lsof -i :18790.
• Server window died → scripts/dev-local.sh logs for the traceback, then restart.
• Stale dev state / want a fresh DB → scripts/dev-local.sh reset then up.