# AGENTS.md — Model Selector

## Purpose
This repo hosts a FastAPI dashboard for browsing and editing the model/provider configuration in `~/.openclaw/openclaw.json`.

## Non-negotiables
- Treat `/home/lucky/.openclaw/openclaw.json` as the canonical source.
- Never edit the live file in tests. Copy it to a temp path and point the app there.
- Preserve unrelated config sections exactly in behavior and key structure.
- Keep alias edits in `agents.defaults.models.<provider/model>.alias`.
- Run the app on port `3300`.

## Working rules
- Read the current JSON shape before changing schema-sensitive code.
- Use atomic writes for config saves.
- Keep provider refresh snapshots local as JSON cache files.
- Prefer explicit provider/model adapters over implicit magic.
- If a capability is not present in provider metadata, show it as missing instead of inventing it.
- Use `./run.sh` to start the app, `./killserver.sh` to clear stale listeners on port `3300`, and `./restart.sh` to do both in sequence.

## Tests
- Use a copied config fixture for all persistence tests.
- Verify that saving aliases does not change the original source file.
- Verify provider cache snapshots are written to local JSON files.
- Verify the dashboard renders both the configured model panel and the provider tabs.