[Agent Setup] Add Command Code setup page - #32649
Conversation
Review💡 1 suggestion found in commit 👉 Fix in your agent 👈Fix the following review findings in PR #32649 (https://github.com/cloudflare/cloudflare-docs/pull/32649).
Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification
- If you disagree (e.g. the fix requires disproportionate effort for minimal benefit,
or the finding is factually incorrect), explain why
- If you need clarification before deciding, ask those questions
- Then share your plan for which issues to tackle and in what order
After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.
The comment must come before the commit — the bot reads PR comments when a new
push triggers a review, so skip comments posted after the push will be missed.
---
## Code Review
### Suggestions (1)
#### CR-f3c6fedb5d00 · Command will not run on Windows
- **File:** `src/content/docs/agent-setup/command-code.mdx` line 49
- **Issue:** Line 36 states the CLI alias is `cmd`, and `cmdc` on Windows, but every example command in the quickstart (lines 49, 57, 65), FAQ (110), and troubleshooting (117, 128, 154, 158) uses `cmd`. On Windows, `cmd` resolves to cmd.exe, so `cmd skills add ...`, `cmd mcp add ...`, and `cmd` will not run for Windows users following the guide.
- **Fix:** Optionally note in the quickstart that the examples assume macOS/Linux and that Windows users should substitute `cmdc`, or add a brief Windows variant note near the first command.
Code ReviewThis code review is in beta and may not always be helpful — use your judgment. Suggestions (1)
ConventionsNo convention issues found. Style Guide ReviewNo style-guide issues found. CommandsOnly codeowners can run commands. Post a comment with the command to trigger it.
|
|
Triage: skipping the 11 style-guide import findings Skipping The agent-setup components are not exported from the barrel. This matches the precedent from #32177, which received the same eleven warnings on Fixing |
Prettier wrapped the `cmd mcp add` command across lines, which leaked the source indentation into the inline code span (the compiled code text contained a literal tab). Keep the command on one line and pin it with prettier-ignore so Prettier does not re-wrap it at 80 columns. Rendered output is unchanged. Addresses CR-b4176969ab76 on cloudflare#32649.
Add a Command Code page to the Agent Setup section, covering install, Cloudflare Skills, the Cloudflare MCP server, tips, FAQ, and troubleshooting. Register the agent in the agent-setup catalog and add its light and dark icons. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Prettier wrapped the `cmd mcp add` command across lines, which leaked the source indentation into the inline code span (the compiled code text contained a literal tab). Keep the command on one line and pin it with prettier-ignore so Prettier does not re-wrap it at 80 columns. Rendered output is unchanged. Addresses CR-b4176969ab76 on cloudflare#32649.
db319cf to
b42c062
Compare
aron-cf
left a comment
There was a problem hiding this comment.
Thanks. I've moved the command code entry into the third row on the main grid, the top six are fixed.
Summary
Adds a new Agent Setup page for Command Code, matching the structure of the existing pages for Claude Code, Codex, Cursor, OpenCode, and Windsurf.
The page covers installing the CLI, installing Cloudflare Skills with
cmd skills add, adding the Cloudflare MCP server over HTTP transport, and running a first session. It reuses the sharedagent-setupcomponents (AgentHeader,PlatformAccessSection,ExamplePromptsList,TipsList,FAQList,TroubleshootingList,OtherAgents) so the platform access matrix, example prompts, and cross-links stay in sync with the rest of the section.Supporting changes:
src/components/agent-setup/agents.tscommand-codeentry so it appears in the agent catalog and gridpublic/icons/agents/command-code/{light,dark}.svgLike
bionic.mdx, this page is not added to the curated landing-page list insrc/components/agents.tsor tosrc/content/agent-setup/prompt.md, which cover a subset of agents plus an "all other agents" fallback.This supersedes #32472, which was opened from a branch with unrelated build-artifact churn.
productionhas been merged into the branch, so it is no longer out of date.Validation run locally at
d7d27fe(the merge commit):pnpm run check— 453 files, 0 errors / 0 warnings / 0 hints; workertsc --noEmitcleanpnpm run lint— cleanpnpm run format:core:check— "All matched files use Prettier code style!"pnpm run build— 8965 pages built, exit 0, no warnings;/agent-setup/command-code/renders and the page is listed in/agent-setup/llms.txtpnpm run test— 15 files, 159 tests passedScreenshots (optional)
n/a — the page uses the shared
agent-setuplayout and components, so it renders identically to the sibling pages.Documentation checklist
b42c062, the last commit that changed page content.