Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,18 @@ If your tool does not support skills, read the file path directly.

### Worktrees & Ports

We use git worktrees for parallel environments. Run `python3 scripts/sync_worktrees.py` to sync config.
We use git worktrees for parallel environments. Config is managed via templates to prevent local leaks.

**Workflow**:

1. Run `python3 scripts/sync_worktrees.py` to generate `supabase/config.toml` and `.env.local` from templates.
2. `supabase/config.toml` is ignored by git; do not track it.

**Troubleshooting**:

- _Config Mismatch_: If ports don't match the table below, re-run `python3 scripts/sync_worktrees.py`.
- _Supabase Failures_: Run `supabase stop --all` then re-run the sync script.
- _Template Changes_: If you need to change shared config, edit `supabase/config.toml.template` in the project root.

| Worktree | Next.js | Supabase API | Postgres |
| :---------- | :------ | :----------- | :------- |
Expand Down
5 changes: 3 additions & 2 deletions docs/DEVELOPMENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,10 +34,11 @@ If you’re trying to understand how to implement something, read:

```bash
pnpm install
cp .env.example .env.local
# Fill in Supabase + database env vars
python3 scripts/sync_worktrees.py
```

This generates `supabase/config.toml` and `.env.local` from templates. These files are ignored by git to keep your local environment clean.

3. **Start Dev Server**

```bash
Expand Down
Loading