Conversation
WalkthroughTwo Markdoc documentation pages were edited. In src/routes/docs/tooling/ai/agents-md/+page.markdoc the AGENTS.md generator URL had its trailing slash removed (https://agentsmd.appwrite.network/ → https://agentsmd.appwrite.network). In src/routes/docs/tooling/ai/ai-dev-tools/+page.markdoc the AGENTS.md link was changed to https://agentsmd.appwrite.io, a new IDE card for Zenflow was added, the Vibe coding tool cards were reworked to render separately for light and dark themes (adding Bolt and theme-specific logo paths), and the file lacks a trailing newline. Estimated code review effort🎯 3 (Moderate) | ⏱️ ~20 minutes 🚥 Pre-merge checks | ✅ 2 | ❌ 1❌ Failed checks (1 inconclusive)
✅ Passed checks (2 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@src/routes/docs/tooling/ai/agents-md/`+page.markdoc:
- Line 21: Replace the broken URL in the line containing "AGENTS.md generator"
by updating the link target from https://agentsmd.appwrite.io to a working
generator (e.g., https://agentsmd.online) or revert to the previous known-good
URL; locate the exact string "Use the [AGENTS.md
generator](https://agentsmd.appwrite.io) to create a custom `AGENTS.md` file for
your project." and change only the URL portion so the markdown link points to a
resolvable domain.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: bf79fba5-fca5-47c3-ad18-2695f9c187a7
⛔ Files ignored due to path filters (8)
static/images/docs/mcp/logos/bolt.svgis excluded by!**/*.svgstatic/images/docs/mcp/logos/dark/bolt.svgis excluded by!**/*.svgstatic/images/docs/mcp/logos/dark/emergent.svgis excluded by!**/*.svgstatic/images/docs/mcp/logos/dark/imagine.svgis excluded by!**/*.svgstatic/images/docs/mcp/logos/dark/lovable.svgis excluded by!**/*.svgstatic/images/docs/mcp/logos/emergent.svgis excluded by!**/*.svgstatic/images/docs/mcp/logos/imagine.svgis excluded by!**/*.svgstatic/images/docs/mcp/logos/lovable.svgis excluded by!**/*.svg
📒 Files selected for processing (2)
src/routes/docs/tooling/ai/agents-md/+page.markdocsrc/routes/docs/tooling/ai/ai-dev-tools/+page.markdoc
| # Generate AGENTS.md {% #generate %} | ||
|
|
||
| Use the [AGENTS.md generator](https://agentsmd.appwrite.network/) to create a custom `AGENTS.md` file for your project. | ||
| Use the [AGENTS.md generator](https://agentsmd.appwrite.io) to create a custom `AGENTS.md` file for your project. |
There was a problem hiding this comment.
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
# Description: Verify the new AGENTS.md generator URL is accessible
# Test: Check if the new URL responds successfully
curl -sI "https://agentsmd.appwrite.io" | head -20Repository: appwrite/website
Length of output: 42
🏁 Script executed:
#!/bin/bash
# Test the new URL with explicit status code and verbose error handling
echo "Testing https://agentsmd.appwrite.io..."
curl -sL -w "\nHTTP Status: %{http_code}\n" -o /dev/null --max-time 5 "https://agentsmd.appwrite.io"
echo "Exit code: $?"Repository: appwrite/website
Length of output: 130
🌐 Web query:
agentsmd.appwrite.io AGENTS.md generator
💡 Result:
No evidence found of agentsmd.appwrite.io existing as a live website or official Appwrite service. The domain does not appear in search results across general web, GitHub, or company directories. AGENTS.md is an open Markdown standard for providing AI coding agents (e.g., Claude Code, Cursor, GitHub Copilot) with repo-specific instructions like build commands, architecture, and conventions. Appwrite repositories use AGENTS.md files, such as in appwrite/console (detailed SvelteKit project instructions) and appwrite/sdk-generator. Appwrite also provides agent-skills (language-specific instruction packs installable via npx skills add appwrite/agent-skills) following agentskills.io standards. General AGENTS.md generators exist (e.g., agentsmd.abvx.xyz CLI for safe updates, puredevtools.tools visual editor, Paldom/agents-init CLI), but none are Appwrite-hosted or at agentsmd.appwrite.io. Appwrite's sdk-generator auto-generates SDKs from specs, not AGENTS.md files.
Citations:
- 1: https://github.com/appwrite/console/blob/main/AGENTS.md
- 2: https://agentsmd.online/
- 3: https://github.com/appwrite/agent-skills
- 4: https://github.com/Paldom/agents-init
- 5: https://github.com/appwrite/sdk-generator/blob/master/AGENTS.md
- 6: https://agentsmd.abvx.xyz/
- 7: https://agents.md/
- 8: https://puredevtools.tools/agents-md-generator
- 9: https://devtk.ai/en/tools/agents-md-generator/
- 10: https://github.com/appwrite/sdk-generator
- 11: https://www.appwrite.io
- 12: https://www.ajgenerator.com
- 13: https://github.com/markoblogo/AGENTS.md_generator
The new URL https://agentsmd.appwrite.io is broken and unresolvable.
DNS resolution fails (CURLE_COULDNT_RESOLVE_HOST), and web search confirms the domain does not exist as a live Appwrite service. The documentation link will break for users. Either revert to the original URL, point to an existing AGENTS.md generator (e.g., agentsmd.online), or delay this change until the new domain is live.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@src/routes/docs/tooling/ai/agents-md/`+page.markdoc at line 21, Replace the
broken URL in the line containing "AGENTS.md generator" by updating the link
target from https://agentsmd.appwrite.io to a working generator (e.g.,
https://agentsmd.online) or revert to the previous known-good URL; locate the
exact string "Use the [AGENTS.md generator](https://agentsmd.appwrite.io) to
create a custom `AGENTS.md` file for your project." and change only the URL
portion so the markdown link points to a resolvable domain.
Greptile SummaryThis PR improves the AI documentation by updating the AGENTS.md generator URL to the new domain, adding Zenflow to the IDEs section, embedding an inline AGENTS.md generator link in the AI dev tools overview page, and introducing a new "Vibe coding" section listing Imagine, Lovable, Emergent, and Bolt. New SVG logos (light and dark variants) are added for all four vibe coding tools.
Confidence Score: 5/5Safe to merge — all linked pages and logo assets exist, markup is well-formed, and no logic or data issues are present. All changes are documentation-only (markdoc content + SVG assets). Every referenced page route and image path was verified to exist in the repository. The {% only_light %} / {% only_dark %} blocks are correctly balanced, and the light/dark logo color assignments are appropriate. No P0 or P1 findings. No files require special attention. Important Files Changed
Reviews (1): Last reviewed commit: "improvements to ai docs" | Re-trigger Greptile |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@src/routes/docs/tooling/ai/ai-dev-tools/`+page.markdoc:
- Line 81: Rewrite the awkward sentence "Generate your own `AGENTS.md` file
depending on the Appwrite services you use in your application using the
[AGENTS.md generator](https://agentsmd.appwrite.network)." to a tighter version
that removes the double "using" and clarifies intent—e.g., "Use the [AGENTS.md
generator](https://agentsmd.appwrite.network) to create an `AGENTS.md` file
tailored to the Appwrite services your application uses." Replace the original
sentence in +page.markdoc (the line containing "AGENTS.md generator") with this
improved wording.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: 1a1c3fb7-233a-4c63-aee1-51b57900fe82
📒 Files selected for processing (2)
src/routes/docs/tooling/ai/agents-md/+page.markdocsrc/routes/docs/tooling/ai/ai-dev-tools/+page.markdoc
✅ Files skipped from review due to trivial changes (1)
- src/routes/docs/tooling/ai/agents-md/+page.markdoc
| When an AI agent encounters an `AGENTS.md` file, it uses the instructions to tailor its responses to your specific project requirements. This includes details about your tech stack, file organization, naming conventions, and architectural patterns. | ||
|
|
||
| Generate your own `AGENTS.md` file depending on the Appwrite services you use in your application using the [AGENTS.md generator](https://agentsmd.appwrite.network/). | ||
| Generate your own `AGENTS.md` file depending on the Appwrite services you use in your application using the [AGENTS.md generator](https://agentsmd.appwrite.network). |
There was a problem hiding this comment.
Tighten phrasing for the AGENTS.md generator sentence.
Line 81 reads awkwardly (“depending on … using …”). A small copy edit will improve clarity.
✏️ Proposed wording tweak
-Generate your own `AGENTS.md` file depending on the Appwrite services you use in your application using the [AGENTS.md generator](https://agentsmd.appwrite.network).
+Generate your own `AGENTS.md` file based on the Appwrite services used in your application with the [AGENTS.md generator](https://agentsmd.appwrite.network).📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| Generate your own `AGENTS.md` file depending on the Appwrite services you use in your application using the [AGENTS.md generator](https://agentsmd.appwrite.network). | |
| Generate your own `AGENTS.md` file based on the Appwrite services used in your application with the [AGENTS.md generator](https://agentsmd.appwrite.network). |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@src/routes/docs/tooling/ai/ai-dev-tools/`+page.markdoc at line 81, Rewrite
the awkward sentence "Generate your own `AGENTS.md` file depending on the
Appwrite services you use in your application using the [AGENTS.md
generator](https://agentsmd.appwrite.network)." to a tighter version that
removes the double "using" and clarifies intent—e.g., "Use the [AGENTS.md
generator](https://agentsmd.appwrite.network) to create an `AGENTS.md` file
tailored to the Appwrite services your application uses." Replace the original
sentence in +page.markdoc (the line containing "AGENTS.md generator") with this
improved wording.
1 participant
Summary by CodeRabbit