[imjlk]

Summary

• document the official Devvit MCP setup for Codex
• direct agents to targeted Devvit documentation search and deployed-app log inspection
• carry the same guidance into the Devvit target README and generated Phaser game template

Why

The repository documented graph-assisted source exploration but not Devvit's official MCP server. Agents could therefore fall back to broad web searches and manual log inspection even when the supported Devvit tools were a better fit.

Impact

This is agent and developer guidance only. The MCP server remains optional, is not bundled into generated apps, and does not change runtime behavior.

Validation

• git diff --check origin/main...HEAD
• Open Code Review completed with no comments; Markdown-only diff was reported as 0 reviewable files
• no changeset required for documentation-only changes

Summary by CodeRabbit

• Documentation
  • Added guidance for configuring the optional Devvit MCP server in Codex.
  • Documented tools for targeted Devvit documentation searches and deployed-app log inspection.
  • Clarified MCP setup, troubleshooting, authentication, and release verification requirements.
  • Added warnings not to include MCP configuration or authentication data in application artifacts.
  • Updated both the current app documentation and the game template documentation.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7308bb70-c197-4187-b6c0-06664b2b8a64

📥 Commits

Reviewing files that changed from the base of the PR and between 8599f11 and cb732f1.

📒 Files selected for processing (3)

• AGENTS.md
• apps/target-devvit/README.md
• packages/cli/templates/phaser-game/apps/target-devvit/README.md

---

📝 Walkthrough

Walkthrough

Adds optional Devvit MCP setup and usage guidance to repository instructions and both Devvit target READMEs, including documentation search, deployed-app logs, restart behavior, and agent-side packaging constraints.

Changes

Devvit MCP Documentation

Layer / File(s)	Summary
MCP setup and usage guidance AGENTS.md, apps/target-devvit/README.md, packages/cli/templates/phaser-game/apps/target-devvit/README.md	Documents Codex registration, devvit_search, devvit_logs, restarting Codex when tools are unavailable, and the exclusion of MCP configuration from build artifacts and authentication or release workflows.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

• imjlk/mpgd-kit#4: Adds the Devvit MCP server configuration and related usage expectations.
• imjlk/mpgd-kit#9: Introduces and expands the Devvit target documentation updated here.

Poem

A bunny found MCP beneath the moon,
Searching Devvit docs with a helpful tune.
Logs hopped out from subreddits bright,
No bundled secrets, all tucked out of sight.
Codex restarted—tools took flight!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title is concise and accurately summarizes the main change: documenting official Devvit MCP guidance for agents.
Description check	✅ Passed	It covers Summary, Why, Impact, and Validation, but omits the template's Notes section and checkbox-style validation items.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/devvit-mcp-guide

---

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.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}