@@ -0,0 +1,41 @@
1+# AGENTS.md
2+
3+## Instruction fidelity
4+
5+When the user asks for a specific change, do exactly that and nothing more.
6+
7+- Do not add extra configuration, defaults, compatibility flags, optimizations, or behavioral changes unless the user explicitly asks for them.
8+- Do not infer "helpful" additions beyond the request.
9+- If a change seems advisable but was not requested, ask first instead of doing it.
10+- Prefer the minimal implementation that satisfies the user's stated request.
11+- If the user asks for only one model / one setting / one change, configure only that.
12+
13+This is the default behavior.
14+
15+## Web search with Exa HTTP API (via curl)
16+
17+Use the `EXA_API_KEY` environment variable and call Exa directly with `curl`.
18+
19+### Basic search
20+
21+```bash
22+curl -sS https://api.exa.ai/search \
23+ -H "x-api-key: $EXA_API_KEY" \
24+ -H "Content-Type: application/json" \
25+ -d '{"query":"your query","numResults":5}'
26+```
27+
28+### Include page text in results
29+
30+```bash
31+curl -sS https://api.exa.ai/search \
32+ -H "x-api-key: $EXA_API_KEY" \
33+ -H "Content-Type: application/json" \
34+ -d '{"query":"your query","numResults":5,"contents":{"text":true}}'
35+```
36+
37+### Notes
38+
39+- Use `-sS` for clean output with visible errors.
40+- Add `-w "\nHTTP_STATUS:%{http_code}\n"` when you want an explicit status code.
41+- The API key must be sent in the `x-api-key` header.