multiple ai files

[elfin ravine]

Hi @sonic root. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:

---

The knowledge sources do not contain enough information to confirm whether generating 20–30 folders of AI files is expected behavior for a new Convex project.

What the docs do mention is that the Convex CLI can install and maintain AI helper files in your project, which include things like:

• convex/_generated/ai/guidelines.md
• Managed sections in AGENTS.md and CLAUDE.md
• Agent skills installed via npx skills

[Convex AI docs]

However, the normal code generation from npx convex dev is expected to create a convex/_generated directory containing just a few files: api.js, api.d.ts, dataModel.d.ts, server.js, and server.d.ts. [Generated Code]

If you're seeing 20–30 folders generated unexpectedly, this doesn't match what the knowledge sources describe as standard behavior. I'd recommend:

1. Checking if you ran npx convex ai-files install or a similar command, which installs AI helper files.
2. If you want to suppress AI file suggestions, you can disable them in convex.json:

{
  "$schema": "./node_modules/convex/schemas/convex.schema.json",
  "aiFiles": {
    "enabled": false
  }
}

[Convex AI docs]

For a definitive answer on whether this is expected, I'd suggest reaching out to the Convex team directly via their Discord or support channels, as the knowledge sources don't cover this specific scenario.

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon:

@sonic root Kapa.ai is still learning and improving, please let me know how I did by reacting below.