# AGENTS.md instructions for Supabase CLI for local Postgres and project workflows

Use Supabase CLI for local Postgres and project workflows only for: Manage local Supabase projects, migrations, generated types, and linked hosted environments from the terminal.

## Default behavior

- Prefer non-interactive commands and stable output formats: json, text.
- Start with read-only inspection commands before changing state.
- Show the exact command before destructive or deployment actions.
- Require explicit user approval for commands marked `requires-review` or `destructive`.

## Useful commands

- safe: `supabase status` — Shows local service URLs and connection information.
- requires-review: `supabase gen types typescript --linked` — Creates TypeScript types from the linked project schema.
- destructive: `supabase db reset` — Drops and rebuilds local data, so it should be confirmed.

## Safety notes

- Agents can safely inspect local status, linked projects, and generated types.
- Database reset, migration repair, secrets, and deploy commands should require approval.
- Use local development projects before touching hosted production data.