Skip to content

armgit / eve

Public Imported from GitHub
0

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.md
new file mode 100644
index 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.ts
index 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.md
index 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. Read
such 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 should
do.
diff --git a/packages/eve/src/setup/scaffold/create/project.ts b/packages/eve/src/setup/scaffold/create/project.ts
index 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 the
installed \`eve\` package location first and read its \`docs/\` directory. If
package 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.ts
index 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