// överenskommelse
AGENTS.md
Hur Codex ska uppträda i det här repot.
För Codex CLI-användare
AGENTS.md talar om för Codex hur den ska arbeta.
Inte vad som finns där.
AGENTS.md sätter arbetsöverenskommelsen. MCP låter Codex nå ut efter verktyg. Maguyva är MCP-servern som ger Codex en sökbar karta över ditt repo, så att den första ändringen inte blir en gissning om filstrukturen.
Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kort.
AGENTS.md är överenskommelsen. MCP är kanalen. Maguyva är kartan.Stacken, lager för lager
Fyra idéer. Var och en gör sitt jobb.
// transport
MCP
Hur Codex når externa verktyg och kontext.
// kodbas
Maguyva
MCP-servern som returnerar förankrade fakta om repot.
// vem betalar
Arbetsytor, inte platser
Agenter betalar inte för platser. Se priser
AGENTS.md är en arbetsöverenskommelse. Använd den.
Beständiga instruktioner hör hemma i AGENTS.md. Det är rätt plats för:
- Bygg-, test- och lintkommandon som Codex ska köra.
- “Gör alltid X / gör aldrig Y”-regler avgränsade till en katalog.
- Namngivningskonventioner och preferenser för refaktorering.
- Hänvisningar till de kanoniska beslutsloggarna och arkitekturanteckningarna.
Håll det kortfattat. Avgränsa det. Committa det.
Men AGENTS.md var aldrig tänkt att vara ett sökbart index över varje symbol, fil och anropsplats i ditt repo.
Var AGENTS.md ensamt blir statiskt i stor skala
Fyra sätt det brister på, ett per kort.
// överenskommelser är inget index
Att tala om för Codex hur den ska arbeta talar inte om vad som finns. Den första ändringen i ett okänt paket blir en gissning om filsökvägar och funktionsnamn. AGENTS.md kan inte lista varje symbol, och det vill du inte heller att den ska.
// dokumentationen glider bort från koden
Ett AGENTS.md-block som beskriver din kötopologi stämmer tills någon inför en ny konsument. Koden är nu sanningen och dokumentationen är övertygande föråldrad. Codex läser fel version.
// namnbyte är ett grafproblem
”Vad refererar till den här klassen?” går inte att besvara från en markdown-fil. Codex tvingas antingen grep:a och hoppas i hela monorepot eller be dig klistra in anropsplatser i chatten.
// kontextfönster är inte gratis
Att stoppa AGENTS.md full tills Codex ”kan tillräckligt” äter upp tokens som borde gå till resonemang. Efter några KB byter du bort svarskvalitet mot statisk kontextvolym.
Så passar de tre lagren ihop
Codex-användare tänker redan i den här formen. Sidan bör göra det uppenbart.
AGENTS.md
överenskommelser
hur Codex uppträder
MCP
kanalen
hur den når ut
Maguyva
kodbasfakta
vad den ser
- AGENTS.md hur Codex uppträder i det här repot.
- MCP hur Codex når verktyg och kontext. (spec)
- Maguyva vad Codex ser när den ställer en fråga till kodbasen. Semantisk, AST-baserad, graf- och textsökning som returneras med filsökvägar och radnummer.
AGENTS.md talar om för Codex hur den ska arbeta.
Maguyva ger Codex något att utgå från.
Tre arbetsflöden
Specifikt för Codex. Förankrat i den faktiska anropsgrafen, inte grep i Codex.
// workflow 01
Döp om en delad klass, hitta alla beroenden först
codex> döp om PaymentClient → BillingClient graph::callers(PaymentClient) 12 referenser i 7 paket graph::importers(src/payments/client.ts) 9 importerare graph::extends(PaymentClient) 2 subklasser (RetryClient, MockClient) → Codex föreslår en migrering med 21 ändringar, med fillistan direkt i svaret. [exit 0]
Codex frågar Maguyva om beroenden innan den börjar redigera. Migreringslistan kommer tillbaka förankrad i den faktiska grafen, inte i vad Codex minns.
// workflow 02
Hitta den verkliga implementationen, inte teststubben
codex> hur hanterar normalizePhoneNumber E.164? semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← verklig impl test/util/phone.spec.ts:14 jest.mock(...) ← stub [exit 0]
Namn ljuger. Mockar skuggar verklig kod. Maguyva rankar den verkliga implementationen över testmocken.
// workflow 03
Kontrollera påverkansradien innan en refaktorering
codex> vad anropar QueueDispatcher.publish? graph::callers(QueueDispatcher.publish) 3 i src/billing/* 1 i src/audit/* 1 i src/notifications/* [exit 0]
Paketöverskridande anropsplatser dyker upp direkt i flödet. Diffen är förankrad i verkliga importerare, inte grep i Codex.
Installation i Codex CLI
Tre steg. Free-nivå: 3 repositorier, Upp till 50K indexerade repo-rader, inget kort.
// step 01
Indexera ett repo på maguyva.ai
Välj ett du känner väl, så att du kan verifiera svaren.
// step 02
Lägg till Maguyva som en MCP-server i din Codex-konfiguration
$ export MAGUYVA_API_KEY=mgv_xxxx $ codex mcp add maguyva --url https://maguyva.tools/mcp \ --bearer-token-env-var MAGUYVA_API_KEY # equivalent ~/.codex/config.toml [mcp_servers.maguyva] url = "https://maguyva.tools/mcp" bearer_token_env_var = "MAGUYVA_API_KEY"// step 03
Ställ en fråga vars svar du redan känner till
Börja inte med hela ditt företag. Börja med ett repo och en verifierbar fråga.