Skip to content

📝 Add an AI section with the MCP server page - #216

Open
bdsoha wants to merge 2 commits into
mainfrom
feature/ai
Open

bdsoha wants to merge 2 commits into
mainfrom
feature/ai

Conversation

@bdsoha

@bdsoha bdsoha commented Nov 15, 2026

Copy link
Copy Markdown
Member

What

  • New main sidebar section AI, after Editor:
    • Overview (/ai/): the agents the workspace ships (Claude Code) or installs as features (Codex, Continue, OpenCode), and how to install one.
    • MCP Server (/ai/mcp): ws-cli serve mcp, its read-only tools, the three tools that act on the workspace, and the WS_AI_MCP_ALLOW_WRITE and WS_AI_MCP_TOOLS settings.
    • Claude Code: the existing /tools/claude page, linked here too. It is not moved.
  • See-also both ways: the Claude Code page links to the two AI pages, and both link back. The ws-cli page links to the MCP page.
  • The Editor sidebar pages are sorted by name (Editor Settings moves up).

To know

  • The two WS_AI_MCP_* settings are written by hand on the MCP page. The synced env reference on main has no ai group yet, and <EnvVar> fails the build for a missing group. 🔄 Sync shared files from ws-meta #215 brings the group; after it merges, the two bullets can become <EnvVar group="ai" … />.
  • The MCP page title carries a next release badge. It needs a manual change to the version at release.
  • The docker run examples use the same image tag as every other page; that tag does not have the feature yet.
  • Registration is documented for Claude Code and Codex only, the two clients it was tried with. Automatic registration does not exist yet.

Verification

  • yarn -s test: 6 passed. yarn -s build: completes, ai/index.html and ai/mcp.html are generated.
  • markdownlint with the repo config is clean on the changed pages.
  • The tool list was checked against the 22 mcp: entries in ws-cli's commands.yaml, and the redaction of secret settings against a live ws-cli.

New main sidebar section `AI`: an overview of the agents the workspace
ships or installs, and a page for `ws-cli serve mcp`. The Claude Code
page is linked from the section and links back through `see:`.

Sort the `Editor` sidebar pages by name.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant