The Open Framework for Building Agents
feat: guide agents to use registry commands in generated `AGENTS.md` (#1286)
Colton Paddenc875a67e8f04
diff --git a/.changeset/init-agents-registry.md b/.changeset/init-agents-registry.mdnew file mode 100644index 000000000..fd7e4d2c0--- /dev/null+++ b/.changeset/init-agents-registry.md@@ -0,0 +1,5 @@+---+"eve": patch+---++Update the generated `AGENTS.md` to direct coding agents to the eve registry for discovering and installing integrations.diff --git a/packages/eve/src/cli/commands/agent-instructions.test.ts b/packages/eve/src/cli/commands/agent-instructions.test.tsindex d369d6d1c..e85ff6423 100644--- a/packages/eve/src/cli/commands/agent-instructions.test.ts+++ b/packages/eve/src/cli/commands/agent-instructions.test.ts@@ -65,6 +65,10 @@ describe("initAgentDevHandoff", () => {expect(handoff).toContain("node_modules/eve/docs/");expect(handoff).toContain("resolve\nthe installed `eve` package location");expect(handoff).toContain("agent/instructions.md");+ expect(handoff).toContain("`eve registry search <query>`");+ expect(handoff).toContain("`eve registry list`");+ expect(handoff).toContain("`eve registry view <item>`");+ expect(handoff).toContain("`eve add <item>`");expect(handoff).not.toContain("/tmp/triage-bot/");// Shared guidance the leaner handoff used to omit now reaches it.@@ -89,6 +93,7 @@ describe("initAgentReplPrompt", () => {expect(prompt).toContain("The project at `.` is already scaffolded.");expect(prompt).toContain("What should the agent do?");+ expect(prompt).toContain("`eve registry search <query>`");expect(prompt).toContain("pnpm exec eve dev --no-ui");expect(prompt).not.toContain("{{");});diff --git a/packages/eve/src/cli/commands/agent-prompt/build-and-verify.md b/packages/eve/src/cli/commands/agent-prompt/build-and-verify.mdindex d847c77e3..7b3e42984 100644--- a/packages/eve/src/cli/commands/agent-prompt/build-and-verify.md+++ b/packages/eve/src/cli/commands/agent-prompt/build-and-verify.md@@ -9,6 +9,10 @@ package docs are unavailable, use https://eve.dev/docs as a fallback. Readsuch as `connections`, `channels/slack`, or `guides/auth-and-route-protection`for the Vercel Connect flow.+Before implementing an integration yourself, use `eve registry search <query>` or+`eve registry list` to discover available integrations. Inspect one with+`eve registry view <item>`, then install it with `eve add <item>`.+- Put the purpose in `agent/instructions.md` (the always-on system prompt),replacing the scaffold's placeholder with what the user said the agent shoulddo.diff --git a/packages/eve/src/setup/scaffold/create/project.ts b/packages/eve/src/setup/scaffold/create/project.tsindex 44f887ddc..aad81a55d 100644--- a/packages/eve/src/setup/scaffold/create/project.ts+++ b/packages/eve/src/setup/scaffold/create/project.ts@@ -268,6 +268,11 @@ from the installed eve package docs. In most installs, those docs are at\`node_modules/eve/docs/\`. In workspaces or local package installs, resolve theinstalled \`eve\` package location first and read its \`docs/\` directory. Ifpackage docs are unavailable, use https://eve.dev/docs as a fallback.++Before implementing an integration yourself, use+\`eve registry search <query>\` or \`eve registry list\` to discover available+integrations. Inspect one with \`eve registry view <item>\`, then install it with+\`eve add <item>\`.`,"CLAUDE.md": `@AGENTS.md`,diff --git a/packages/eve/src/setup/scaffold/index.integration.test.ts b/packages/eve/src/setup/scaffold/index.integration.test.tsindex a4b7fee51..31a79c5ff 100644--- a/packages/eve/src/setup/scaffold/index.integration.test.ts+++ b/packages/eve/src/setup/scaffold/index.integration.test.ts@@ -916,6 +916,10 @@ describe("scaffoldBaseProject", () => {expect(agentsMd).toContain("installed eve package docs");expect(agentsMd).toContain("node_modules/eve/docs/");expect(agentsMd).toContain("resolve the\ninstalled `eve` package location");+ expect(agentsMd).toContain("`eve registry search <query>`");+ expect(agentsMd).toContain("`eve registry list`");+ expect(agentsMd).toContain("`eve registry view <item>`");+ expect(agentsMd).toContain("`eve add <item>`");// `vercel deploy` uploads everything a .vercelignore doesn't exclude, and// the platform default-ignores only the .env.local variants — eve's dev// artifacts and a bare .env must be excluded here or a source deploy